BBS in a Box 4

home *** CD-ROM | disk | FTP | other *** search

/ BBS in a Box 4 / BBS in a Box - Macintosh - Volume IV (January 1992) (BBS in a Box).iso / Files / MacTechNotes / MacTN files by name < prev next >

Wrap

Text File | 1991-11-17 | 160.5 KB | 3,071 lines | [TEXT/QED1]

Name = 0 About Mac TNs 04.91.cpt Path = AMUG CD:Files:MacTechNotes:0 About Mac TNs 04.91.cpt Size: 24K Date: 2/15/91 Version: AMUG file information and description: 0 About Mac TNs 4.91 - contains an index to the 4-91 Tech notes. Name = Fonts (New Format).dd Path = AMUG CD:Files:MacTechNotes:Fonts (New Format).dd Size: 32K Date: 2/15/91 Version: AMUG file information and description: Fonts (New Format).dd contains new formated fonts for displaying Tech Notes in this section. Name = Fonts (Old Format).dd Path = AMUG CD:Files:MacTechNotes:Fonts (Old Format).dd Size: 26K Date: 2/15/91 Version: AMUG file information and description: Fonts (Old Format).dd contains old style formated fonts for displaying Tech Notes in this section. Name = Human Interface Notes.dd Path = AMUG CD:Files:MacTechNotes:Human Interface Notes.dd Size: 28K Date: 2/15/91 Version: AMUG file information and description: Human Interface Notes.dd are the Human Interface Tech Notes from Apple Computer. Name = Sound Manager chapter (IM).dd Path = AMUG CD:Files:MacTechNotes:Sound Manager chapter (IM).dd Size: 80K Date: 2/15/91 Version: AMUG file information and description: Sound Manager chapter (IM).dd contains specialized information on the Macintosh Sound Manager. Name = TN.001.System Resources Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.001.System Resources Size: 3K Date: 2/15/91 Version: AMUG file information and description: This note formerly described a strategy for dealing with system resources from desk accessories. We no longer recommend calling ReleaseResource or DetachResource for a system resource. When you are done with a system resource, leave it alone; do not try to dispose or release it. Name = TN.002.Compatibility Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.002.Compatibility Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.002.Compatibility - Apple has many enhancements planned for the Macintosh family of computers. To help ensure your software’s compatibility with these enhancements, check each item in this note to be sure that you’re following the recommendations. If your software is written in a high-level language like Pascal or C and if you adhere to the guidelines listed in Inside Macintosh, many of the questions in this note won’t concern you. If you develop in assembly language, you should read each question carefully. Name = TN.003.Command-Shift Keys Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.003.Command-Shift Keys Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.003.Command-Shift Keys - In the standard system, there are two Command-Shift-number key combinations that are automatically captured and processed by GetNextEvent. The combinations are: Command-Shift-1 Eject internal disk Command-Shift-2 Eject external disk. Numbers from 3 to 9 are also captured by GetNextEvent, but are processed by calling ‘FKEY’ resources. You can implement your own actions for Command-Shift-number combinations for numbers 5 to 9 by defining your own ‘FKEY’ resource. Name = TN.004.GetNewDialog Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.004.GetNewDialog Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.004.GetNewDialog - When calling GetNewDialog to retrieve a dialog template from a previously opened resource file, how are error conditions indicated to the caller? Unfortunately, they aren’t. The Dialog Manager calls GetResource and assumes the returned value is good. Since the Dialog Manager doesn’t check, you have two choices. Your first choice is to call GetResource for the dialog template, item list, and any resources needed by items in the item list yourself. But what do you do when you find the resources aren’t there? Name = TN.005.Dialogs from DAs Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.005.Dialogs from DAs Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.005.Dialogs from DAs - When a desk accessory creates a window (including a modeless dialog window) it must set the windowKind to its refnum—a negative number. When the application calls GetNextEvent, the Event Manager calls SystemEvent, which checks to see if the event belongs to a desk accessory. SystemEvent checks the windowKind of the frontmost window, and uses the (negative) number for the refnum to make a control call, giving the desk accessory a shot at the event. Then SystemEvent returns TRUE, and GetNextEvent returns FALSE. Name = TN.006.Owned Resources Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.006.Owned Resources Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.006.Owned Resources - To allow the Font/DA Mover to renumber desk accessories as needed when moving them between system files, desk accessories should use the “owned resource” protocol described in the Resource Manager chapter of Inside Macintosh Volume I. Name = TN.007.Debugging Tips Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.007.Debugging Tips Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.007.Debugging Tips - This presents a few tips which may make your debugging easier. Setting memory location 0 to something odd Dereferencing nil handles can cause real problems for an application. If location 0 (nil) is something even, the dereference will not cause an address error, and the application can run on for quite a while, making tracing back to the problem quite difficult. If location 0 contains something odd, such as $50FFC001, an address error will be generated immediately when a nil handle is dereferenced. Name = TN.008.ABPasIntf Bug Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.008.ABPasIntf Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.008.ABPasIntf Bug - Previous versions of this note described a bug in the AppleTalk Pascal Interfaces. This bug was fixed in MPW 1.0 and newer. Name = TN.009.Internets Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.009.Internets Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.009.Internets - Individual AppleTalk networks can be connected together as internets. It’s important that your application work across internets; this note contains information on the differences between life on a single AppleTalk, and life on an internet. You can read about internets (AppleTalk networks connected by one or more bridges) in Inside AppleTalk. What do you need to do about them? Name = TN.010.Pinouts Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.010.Pinouts Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.010.Pinouts - This note gives pinouts for Macintosh ports, cables, and other products. Inside are pinout descriptions for the Macintosh ports, cables, and various other products. Please refer to the Hardware chapter of Inside Macintosh and the Macintosh Hardware Reference Manual for more information, especially about power limits. Note that unconnected pins are omitted. Name = TN.011.Memory-Based MW Format Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.011.Memory-Based MW Format Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.011.Memory-Based MW Format - This Technical Note formerly described the format of files created by MacWrite® 2.2. Changes since March 1988: Updated the Claris address. Name = TN.012.Disk-Based MW Format Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.012.Disk-Based MW Format Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.012.Disk-Based MW Format - This Technical Note formerly described the format of files created by MacWrite®, which is now published by Claris. Changes since March 1988: Updated the Claris address. Name = TN.013.MW Clipboard Format Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.013.MW Clipboard Format Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.013.MW Clipboard Format - This Technical Note formerly described the clipboard format used by MacWrite®, which is now published by Claris. Changes since March 1988: Updated the Claris address. Name = TN.014.INIT 31 Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.014.INIT 31 Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.014.INIT 31 - This note formerly described things that are now covered in the System Resource File chapter of Inside Macintosh Volume IV and the Start Manager chapter of Inside Macintosh Volume V. Please refer to Inside Macintosh. Name = TN.015.Finder 4.1 Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.015.Finder 4.1 Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.015.Finder 4.1 - This note formerly described Finder 4.1, which is now recommended only for use with 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.016.MacWorks XL Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.016.MacWorks XL Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.016.MacWorks XL - Earlier versions of this note described MacWorks XL, the system software that allowed you to use Macintosh applications on the Macintosh XL. Information specific to Macintosh XL machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.017.Low-Level Print Driver Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.017.Low-Level Print Driver Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.017.Low-Level Print Driver - This technical note has been replaced by information in Inside Macintosh Volume V. Please refer to the Print Manager chapter of Inside Macintosh Volume V for information on low-level print driver calls. Name = TN.018.TextEdit Conversion Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.018.TextEdit Conversion Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.018.TextEdit Conversion - Text sometimes must be converted between a Pascal string and “pure” text in a handle. This note illustrates a way to do this using MPW Pascal. Text contained in TextEdit records sometimes must be passed to routines which expect a Pascal string of type Str255 (a length byte followed by up to 255 characters). Name = TN.019.Clickless Sound Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.019.Clickless Sound Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.019.Clickless Sound - Apple currently discourages use of the Sound Driver due to compatibility issues. The hardware support for sound designed into the early Macintosh architecture was minimal. (Many things have changed since 1983–1984.) The new Macintosh computers contain a custom chip to provide better support for sound, namely the Apple Sound Chip (ASC). The ASC is present in the complete Macintosh II family as well as the Macintosh SE/30 and later machines. Name = TN.020.Server Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.020.Server Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.020.Server - Many applications could benefit from the ability to share common data between several Macintoshes, without requiring a file server. This technical note discusses one technique for managing this AppleTalk communication. Name = TN.021.Picture Opcodes Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.021.Picture Opcodes Size: 13K Date: 2/15/91 Version: AMUG file information and description: TN.021.Picture Opcodes - This technical note describes the internal format of the QuickDraw picture data structure. This revision corrects some errors in the opcode descriptions and provides some examples. Name = TN.022.TEScroll Bug Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.022.TEScroll Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.022.TEScroll Bug - A bug in TextEdit causes the following problem: a call to TEScroll with no horizontal or vertical displacement (that is, both dh and dv set to zero) results in disappearance of the insertion point. Since such calls do nothing, they should be avoided. Name = TN.023.Font/DA Mover Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.023.Font/DA Mover Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.023.Font/DA Mover - This technical note describes how to make sure that your desk accessory will work after being moved by Font/Desk Accessory Mover. Name = TN.024.Available Volumes Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.024.Available Volumes Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.024.Available Volumes - Standard File lets the user select one file from any available volume; it is sometimes necessary for an application to find which volumes are present. This technical note gives the proper method of accomplishing this. Name = TN.025.A5 & Patching Traps Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.025.A5 & Patching Traps Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.025.A5 & Patching Traps - Future software may allow desk accessories to have their own globals by changing register A5 when the accessory is entered and exited. This can cause problems for applications that patch traps without following certain rules. Name = TN.026.Text Widths Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.026.Text Widths Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.026.Text Widths - This technical note discusses the fact that the width of a string is not always the same as the sum of the widths of all the characters in the string, due to roundoff error. Name = TN.027.MacDraw’s PICT Format Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.027.MacDraw’s PICT Format Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.027.MacDraw’s PICT Format - This Technical Note formerly described the PICT file format used by MacDraw® and the picture comments the MacDraw used to communicate with the LaserWriter driver. Changes since March 1988: Updated the Claris address. Name = TN.028.Finders & Drives Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.028.Finders & Drives Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.028.Finders & Drives - This technical note describes the differences in the way the 1.1g, 4.1, 5.0 and newer Finders communicate with foreign (non-Sony) disk drives. Name = TN.029.Desktop File Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.029.Desktop File Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.029.Desktop File - This technical note describes the resources found in the Desktop file. Note: Don’t base anything critical on the format of the Desktop file. AppleShare already uses another scheme; AppleShare volumes don’t have Desktop files. The format of this file can, and probably will, change in the future. Name = TN.030.Font Height Tables Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.030.Font Height Tables Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.030.Font Height Tables - This technical note describes how the Font Manager (except in 64K ROMs) calculates height tables for fonts and how you can force recalculation. Name = TN.032.Reserved Types Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.032.Reserved Types Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.032.Reserved Types - Your applications and desk accessories can create their own resource types. To avoid using type names which have been or will be used in the system, Apple has reserved all resource type names which consist entirely of spaces ($20), lower-case letters ($61 through $7A), and “international” characters (greater than $7F). Name = TN.033.IW II Paper Motion Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.033.IW II Paper Motion Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.033.IW II Paper Motion - The purpose of this technical note is to answer the many questions asked about why the paper moves the way it does on the ImageWriter II. Name = TN.034.User Items in Dialogs Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.034.User Items in Dialogs Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.034.User Items in Dialogs - The Dialog Manager does not go into detail about how to manage user items in dialogs; this Technical Note describes the process. Changes since March 1, 1988: Added MPW C 3.0 code, added a _SetPort call to the Pascal example, and noted the necessity and meaning of enabled items. Name = TN.035.DrawPicture Problem Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.035.DrawPicture Problem Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.035.DrawPicture Problem - This note formerly described a problem with DrawPicture that occurred only on 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.036.Drive Queue Elements Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.036.Drive Queue Elements Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.036.Drive Queue Elements - This note expands on Inside Macintosh’s definition of the drive queue, which is given in the File Manager chapter. Name = TN.037.Logic Boards Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.037.Logic Boards Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.037.Logic Boards - Earlier versions of this note are obsoleted by existence of SysEnvirons, which is documented in Technical Note #129. Name = TN.038.ROM Debugger Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.038.ROM Debugger Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.038.ROM Debugger - The debugger in ROM (not present on the Macintosh 128, Macintosh 512, or Macintosh XL) recognizes the following commands: PC [expr] (program counter)Typing PC on a line by itself displays the program counter. Typing PC 50000 sets the program counter to $50000. SM [address [number(s)]] (set memory) Typing SM on a line by itself displays the next 96 bytes of memory. Typing SM 50000 will display memory starting at $50000. Typing SM 50000 4849 2054 6865 7265 2120 will set memory starting at $50000 to $4849… Subsequently hitting Return will increment the display a screen at a time. Name = TN.039.Segment Loader Patch Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.039.Segment Loader Patch Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.039.Segment Loader Patch - This note formerly described a patch to the Segment Loader for 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.040.Finder Flags Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.040.Finder Flags Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.040.Finder Flags - This revision corrects the meanings of bits 6 and 7, which were interchanged in the older version of this technical note. ResEdit uses these bits incorrectly in versions older than 1.2. Name = TN.041.Off-Screen Bitmaps Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.041.Off-Screen Bitmaps Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.041.Off-Screen Bitmaps - This Technical Note provides an example of creating an off-screen bitmap, drawing to it, and then copying from it to the screen. Changes since April 1990: Clarified the section on window updates with off-screen bitmaps to explicitly limit these updates to your own windows. Name = TN.042.Pascal Routine Pointers Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.042.Pascal Routine Pointers Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.042.Pascal Routine Pointers - Routines passed by pointer are used in many places in conjunction with Macintosh system routines. For example, filter procedures for modal dialogs are passed by pointer, as are controls’ action procedures (when calling TrackControl), and I/O completion routines. Name = TN.043.Calling LoadSeg Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.043.Calling LoadSeg Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.043.Calling LoadSeg - Earlier versions of this note described a way to call the LoadSeg trap, which is used internally by the Segment Loader. We no longer recommend calling LoadSeg directly. Name = TN.044.HFS Compatibility Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.044.HFS Compatibility Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.044.HFS Compatibility - This technical note tells you how to make sure that your applications run under the Hierarchical File System (HFS). Name = TN.045.ROM Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.045.ROM Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.045.ROM - This note formerly listed the traps from Inside Macintosh Volumes I-III. Better references are now available elsewhere. Name = TN.046.Separate Resource Files Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.046.Separate Resource Files Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.046.Separate Resource Files - During application development, you use a resource compiler (RMaker or Rez) to convert a resource definition file into an executable application. You rarely change anything but your CODE resources during development, and the resource compiler spends a lot of time compiling other resources which have not changed since they were originally created. Name = TN.047.Standard File Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.047.Standard File Size: 24K Date: 2/15/91 Version: AMUG file information and description: TN.047.Standard File - This note contains an example program that demonstrates how SFPGetFile can be customized using the dialog hook and file filter functions. Name = TN.048.Bundles Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.048.Bundles Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.048.Bundles - This note describes what a bundle is and how to create one. A bundle is a collection of resources. Bundles can be used for a number of different purposes, and are currently used by the Finder ito tie an icon to a file type, allowing your application or data file to have its own icon. Name = TN.050.Calling SetResLoad Path = AMUG CD:Files:MacTechNotes:TN.001.050:TN.050.Calling SetResLoad Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.050.Calling SetResLoad - Calling SetResLoad(FALSE) can be useful if you need to get a handle to a resource, without causing the resource to be loaded from disk if it isn’t already in memory. This technique is used in Technical Note #1. SetResLoad changes the value of the low-memory global ResLoad (at location $A5E). Name = TN.051.Debugging w/PurgeMem Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.051.Debugging w/PurgeMem Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.051.Debugging w/PurgeMem - If you are having problems finding bugs like handles that aren’t locked down when they should be, or resources that aren’t there when they’re supposed to be, there is a handy technique for forcing these problems to the surface. Name = TN.052._Launch from High-Level Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.052._Launch from High-Level Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.052._Launch from High-Level - This Technical Note formerly discussed calling _Launch from a high-level language which allows inline assembly code. Changes since March 1988: Merged contents into Technical Note #126. Name = TN.053.MoreMasters Revisited Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.053.MoreMasters Revisited Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.053.MoreMasters Revisited - MoreMasters should be called from CODE segment 1. The number of master pointers that a program needs can be determined empirically. MoreMasters can be tricked into creating the exact number of master pointers desired. Name = TN.054.Limit to Resource Size Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.054.Limit to Resource Size Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.054.Limit to Resource Size - This note formerly described a bug in WriteResource on 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.055.Drawing Icons Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.055.Drawing Icons Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.055.Drawing Icons - Using resources of type ICON allows drawing of icons in srcOr mode. Using resources of type ICN# allows for more variety when drawing icons. Name = TN.056.Break/CTS Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.056.Break/CTS Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.056.Break/CTS - This technical note documents the event record information that gets passed when the serial driver posts an event for a break/CTS status change. Name = TN.057.Macintosh Plus Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.057.Macintosh Plus Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.057.Macintosh Plus - This note was originally meant as interim Macintosh Plus documentation and has been replaced by Inside Macintosh Volume IV, which is more complete and more accurate. Name = TN.058.IU Bug Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.058.IU Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.058.IU Bug - This note formerly described a bug in System 2.0, which is now recommended only for use with 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.059.Pictures & Clip Regions Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.059.Pictures & Clip Regions Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.059.Pictures & Clip Regions - This note describes a problem that affects creation of QuickDraw pictures. When a GrafPort is created, the fields in the GrafPort are given default values; one of these is the clip region, which is set to the rectangle (–32767, –32767, 32767, 32767). If you create a picture, then call DrawPicture with a destination rectangle that is not the same size as the picFrame without ever changing the default clip region, nothing will be drawn. Name = TN.060.Narrow GrafPorts Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.060.Narrow GrafPorts Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.060.Narrow GrafPorts - When you draw a character into a GrafPort, your program will die with an address error if the width of the GrafPort is smaller than the width of the character. If you check before drawing the character to see if the GrafPort is wide enough, you can avoid this unfortunate tragedy. Name = TN.061.GetItemStyle Bug Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.061.GetItemStyle Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.061.GetItemStyle Bug - This note formerly described a bug (in GetItemStyle) which occurs only on 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.062.Resource Header Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.062.Resource Header Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.062.Resource Header - The section of the Resource Manager chapter of Inside Macintosh which describes the internal format of a resource file shows an area of the resource header labeled “available for application data.” You should not use this area—it is used by the Resource Manager. Name = TN.063.WriteResource Patch Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.063.WriteResource Patch Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.063.WriteResource Patch - This note formerly contained a patch to fix a bug in WriteResource on 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.064.IZANotify Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.064.IZANotify Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.064.IZANotify - Previous versions of this technical note recommended use of a low memory hook called IAZNotify. We no longer recommend use of IAZNotify, since the IAZNotify hook is never called under MultiFinder. Name = TN.065.Mac Plus Pinouts Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.065.Mac Plus Pinouts Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.065.Mac Plus Pinouts - This note gives pinout descriptions for some of the Macintosh Plus ports and Macintosh Plus cables that are different than the Macintosh 128K and 512K. Name = TN.066.Which File System? Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.066.Which File System? Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.066.Which File System? - This Technical Note discusses how to determine which file system a particular volume is running. Changes since June 1990: Removed text about IDs $0001-$0016 being AppleShare volumes; other file systems use this range tooUnder certain circumstances it is necessary to determine which file system is currently running on a particular volume. For example, on a 64K ROM machine, your application (i.e., especially disk recovery utilities or disk editors, etc.) may need to check for MFS versus HFS. Note that this is usually not necessary, because all ROMs, except the original 64K ROMs, include HFS. You may need to check if a particular volume is in High Sierra, ISO 9660, or audio CD format. Name = TN.067.Blessed Folder Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.067.Blessed Folder Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.067.Blessed Folder - This technical note describes how to determine which folder on an HFS volume is the blessed folder, that is, the folder that contains both the System file and the Finder. Name = TN.068.Searching All Dirs Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.068.Searching All Dirs Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.068.Searching All Dirs - This Technical Note provides a simple algorithm for searching all directories on an HFS volume. Changes since March 1, 1988: Previously we stopped the whole search when we encountered any error, which caused trouble with privilege errors on AppleShare volumes. Now an error will only stop the enumeration of a particular catalog. Name = TN.069.PBGetCatInfo Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.069.PBGetCatInfo Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.069.PBGetCatInfo - This technical note describes how to set ioFDirIndex for PBGetCatInfo. The File Manager chapter of Inside Macintosh volume IV is not very specific in describing how to use ioFDirIndex when calling PBGetCatInfo. It correctly says that ioFDirIndex should be positive if you are making indexed calls to PBGetCatInfo (analogous to making indexed calls to PBGetVInfo as described in Technical Note #24). Name = TN.070.Single-Sided Disks Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.070.Single-Sided Disks Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.070.Single-Sided Disks - This document explains how to initialize a disk as either single- or double- sided. It only applies to 800K drives, of course. Name = TN.071.Finding Drivers Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.071.Finding Drivers Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.071.Finding Drivers - This note will explain how code can be written to determine the reference number of a previously installed driver when only the name is known. Changes since 2/86: Since the driver can be purged and the DCE still be allocated, the code now tests for dCtlDriver being NIL as well. Name = TN.072.LW Optimizing Techniques Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.072.LW Optimizing Techniques Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.072.LW Optimizing Techniques - This Technical Note discusses techniques for optimizing code for printing on the LaserWriter. Changes since March 1988: Updated the “Printable Paper Area” and “Memory Considerations” sections as well as the printer IDs, moved the error messages from the end of the Note to Technical Note #161, A Printing Loop That Cares…, and removed the “Spool-A-Page/Print-A-Page” section because Technical Note #125, Effect of Spool-A-Page/Print-A-Page on Shared Printers, already thoroughly covers this topic. Name = TN.073.Color Printing Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.073.Color Printing Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.073.Color Printing - This discusses color printing in a Macintosh application. Whereas the original eight-color model of QuickDraw was sufficient for printing in color on the ImageWriter II, the introduction of Color QuickDraw has created the need for more sophisticated printing methods. Name = TN.074.Data In Resource Fork Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.074.Data In Resource Fork Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.074.Data In Resource Fork - Don’t use the resource fork of a file for non-resource data. Parts of the system (including the File Manager and the Finder) assume that if this fork exists, it will contain valid Resource Manager information. PBOpenRF was provided to allow copying of the resource fork of a file in its entirety, without Resource Manager interpretation. Do not use it to open “another data fork.” Name = TN.075.Multidisk Installer+ Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.075.Multidisk Installer+ Size: 6K Date: 5/18/91 Version: AMUG file information and description: #75 - Apple’s Multidisk Installer. Revised by - Jon Zap April 1991. Written by Scott Douglass March 1986. This Technical Note documents Apple’s Multidisk Installer, and it is in addition to separate Installer documentation which provides the details of writing scripts. Changes since February 1991 Revised information about where to find the Multidisk Installer reference suite. Name = TN.076.Mac Plus Update Script Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.076.Mac Plus Update Script Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.076.Mac Plus Update Script - Earlier versions of this note described the Macintosh Plus Update installation script, because it was the first script created for the Installer. Since then, many versions of this script have been created which no longer match what was described here. In addition, many other scripts now exist. Name = TN.077.HFS Ruminations Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.077.HFS Ruminations Size: 14K Date: 2/15/91 Version: AMUG file information and description: TN.077.HFS Ruminations - This technical note contains some thoughts concerning HFS. HFS numbers. A drive number is a small positive word (e.g. 3). A VRefNum (as opposed to a WDRefNum) is a small negative word (e.g. $FFFE). A WDRefNum is a large negative word (e.g. $8033). A DirID is a long word (e.g. 38). The root directory of an HFS volume always has a dirID of 2. Name = TN.078.Resource Manager Tips Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.078.Resource Manager Tips Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.078.Resource Manager Tips - This note discusses some problems with the Resource Manager and how to work around them. OpenResFile Bug. This section of the note formerly described a bug in OpenResFile on 64K ROM machines. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.079._ZoomWindow Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.079._ZoomWindow Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.079._ZoomWindow - This Technical Note contains some hints about using _ZoomWindow. Changes since March 1988: Added a discussion of and sample code to demonstrate recommended window zooming technique in multi-screen environments. Basics _ZoomWindow allows a window to be toggled between two states (where “state” means size and location): a default state and a user-selectable state. The default state stays the same unless the application changes it, while the user-selectable state is altered when the user changes the size or location of a zoomable window. The code to handle zoomable windows in a main event loop would look something like the examples which follow. Name = TN.080.SF Tips Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.080.SF Tips Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.080.SF Tips - SFSaveDisk and CurDirStore. Low-memory location $214 (SFSaveDisk—a word) contains –1* the vRefNum of the volume that SF is displaying (MFS and HFS). It never contains –1* a WDRefNum. Low-memory location $398 (CurDirStore—a long word) contains the dirID of the directory that SF is displaying (HFS only). This information can be particularly useful at hook time, when the vRefNum field of the reply record has not yet been filled in. Name = TN.081.Caching Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.081.Caching Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.081.Caching - This technical note describes disk and File System caching on the Macintosh, with particular emphasis on the high-level File System cache. Of the three caches used for file I/O, this is the one which could have the most impact on your program. Note: This big File System cache is not available on 64K ROM machines. Name = TN.082.TextEdit Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.082.TextEdit Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.082.TextEdit - This technical note will point out some bugs (and possible workarounds), and other items of interest for the TextEdit programmer. Name = TN.083.System Heap Size Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.083.System Heap Size Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.083.System Heap Size - Earlier versions of this note pointed out that, due to varying system heap sizes, the application heap does not always start at $CB00. The start of the application heap has not been fixed for some time now; programs that depend on it never work on the Macintosh SE or the Macintosh II. Name = TN.084.Edit File Format Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.084.Edit File Format Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.084.Edit File Format - This technical note describes the format of the files created by Edit. It has been verified for versions 1.x and 2.0. Edit, a text editor licensed by Apple and included in the Consulair 68000 Development System, can read any text-only file whose file type is TEXT. Files created by Edit have a creator ID of EDIT. Edit is a disk-based editor so the file length is not limited by available memory. Name = TN.085.GetNextEvent & Blinkin' Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.085.GetNextEvent & Blinkin' Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.085.GetNextEvent & Blinkin' - Wherein arcane mysteries are unraveled so you can make the Alarm Clock (or a similar desk accessory) blink the Apple menu at the appointed second. Also, why GetNextEvent is a good thing. Name = TN.086.MacPaint Document Format Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.086.MacPaint Document Format Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.086.MacPaint Document Format - This Technical Note describes the internal format of a MacPaint® document, which is a standard used by many other programs. This description is the same as that found in the “Macintosh Miscellaneous” section of early Inside Macintosh versions. Changes since October 1988: Fixed bugs in the example code. Name = TN.087.Error in FCBPBRec Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.087.Error in FCBPBRec Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.087.Error in FCBPBRec - The declaration of a FCBPBRec is wrong in Inside Macintosh Volume IV and early versions of MPW. This has been fixed in MPW 1.0 and newer. An error was made in the declaration of an FCBPBRec parameter block that is used in PBGetFCBInfo calls. The field ioFCBIndx was incorrectly listed as a LONGINT. The following declaration (found in Inside Macintosh): Name = TN.088.Signals Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.088.Signals Size: 14K Date: 2/15/91 Version: AMUG file information and description: TN.088.Signals - Signals are a form of intra-program interrupt which can greatly aid clean, inexpensive error trapping in stack frame intensive languages. A program may invoke the Signal procedure and immediately return to the last invocation of CatchSignal, including the complete stack frame state at that point. Name = TN.089.DrawPicture Bug Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.089.DrawPicture Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.089.DrawPicture Bug - Earlier versions of this note described a bug in DrawPicture. This bug never occurred on 64K ROM machines, and has been fixed in System 3.2 and newer. Use of Systems older than 3.2 on non-64K ROM machines is no longer recommended. Name = TN.090.SANE Incompatibilities Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.090.SANE Incompatibilities Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.090.SANE Incompatibilities - Earlier versions of this note described a problem with SANE and System 2.0. Use of System 2.0 is only recommended for Macintosh 128 machines, which contain the 64K ROMs. Information specific to 64K ROM machines has been deleted from Macintosh Technical Notes for reasons of clarity. Name = TN.091.LW PicComments Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.091.LW PicComments Size: 33K Date: 2/15/91 Version: AMUG file information and description: TN.091.LW PicComments - This technical note is a continuation of Technical Note #72. This technical note discusses the picture comments that the LaserWriter driver recognizes. This technical note has been modified to include corrected descriptions of the SetLineWidth, PostScriptFile and ResourcePS comments and to include some additional warnings. Name = TN.092.Appearance Of Text Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.092.Appearance Of Text Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.092.Appearance Of Text - This technical note describes why text doesn’t always look the way you expect depending on the environment you are in. There are a number of Macintosh text editing applications where layout is critical. Unfortunately, text on a newer machine sometimes prints differently than text on a 64K ROM Macintosh. Let’s examine some differences you should expect and why. Name = TN.093.MPW {$LOAD} Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.093.MPW {$LOAD} Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.093.MPW {$LOAD} - This technical note discusses the Pascal {$LOAD} directive as well as how to unload the _DataInit and %_MethTables segments.{$LOAD} MPW Pascal has a {$LOAD} directive that can dramatically speed up compiles. Name = TN.094.Tags Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.094.Tags Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.094.Tags - Apple has decided to eliminate support for file-system tags on its future products; this technical note explains this decision. Some of Apple’s disk products (and some third-party products) have the ability to store 532 bytes per sector, instead of the normal 512. Twelve of the extra bytes are used to store redundant file system information, known as “tags”, to be used by a scavenging utility to reconstruct damaged disks. Name = TN.095.Print Dialogs Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.095.Print Dialogs Size: 27K Date: 2/15/91 Version: AMUG file information and description: TN.095.Print Dialogs - This technical note discusses how to add your own items to the Printing Manager’s dialogs. When the Printing Manager was initially designed, great care was taken to make the interface to the printer drivers as generic as possible in order to allow applications to print without being device-specific. Name = TN.096.SCSI Bugs Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.096.SCSI Bugs Size: 14K Date: 2/15/91 Version: AMUG file information and description: TN.096.SCSI Bugs - There are a number of problems in the SCSI Manager; this note lists the ones we know about, along with an explanation of what we’re doing about them. Changes made for the 2/88 release are made to more accurately reflect the state of the SCSI Manager. System 4.1 and 4.2 are very similar; one bug was fixed in System 4.2. Name = TN.097.PrSetError Problem Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.097.PrSetError Problem Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.097.PrSetError Problem - This note formerly described a problem in Lisa Pascal glue for the PrSetError routine. The glue in MPW (and most, if not all, third party compilers) does not have this problem. Name = TN.098.Short-Circuit Booleans Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.098.Short-Circuit Booleans Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.098.Short-Circuit Booleans - This note formerly described problems with the Lisa Pascal compiler. These problems have been fixed in the MPW Pascal compiler. Name = TN.099.SF Bug in System 3.2 Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.099.SF Bug in System 3.2 Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.099.SF Bug in System 3.2 - This note formerly described a bug in Standard File in System 3.2. This bug has been fixed in more recent Systems. Name = TN.100.Large Screen Displays Path = AMUG CD:Files:MacTechNotes:TN.051.100:TN.100.Large Screen Displays Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.100.Large Screen Displays - A number of third-party developers have announced large-screen display peripherals for Macintosh. One of them, Radius Inc., has issued a set of guidelines for developers who wish to remain compatible with their Radius FPD; unfortunately, one of their recommendations can cause system crashes. This note suggests a more correct approach. Name = TN.101.CreateResFile & PMSP Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.101.CreateResFile & PMSP Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.101.CreateResFile & PMSP - CreateResFile checks to see if a resource file with a given name exists, and if it does, returns a dupFNErr (–48) error. Unfortunately, to do this check, CreateResFile uses a call that follows the Poor Man’s Search Path (PMSP). Name = TN.102.HFS Elucidations Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.102.HFS Elucidations Size: 13K Date: 2/15/91 Version: AMUG file information and description: TN.102.HFS Elucidations - This technical note will describe a few problems that can occur while using HFS. It will also describe ways to avoid these problems. This technical note will discuss the following problems. 1) It is very important to be careful about how files are opened and closed. There must be no more than one close for every open. 2) Don’t use Driver names, like .Bout, .Print or .Sony, in place of file names or the file system will become confused. 3) Be aware of the ioFlVersNum byte in all file calls. A number of pieces of the Macintosh system do not use, and may in fact ignore, files created with non-zero ioFlVersNums. Name = TN.103.128K ROM/Asm Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.103.128K ROM/Asm Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.103.128K ROM/Asm - When calling MaxApplZone and MoveHHi from assembly language, be sure to get the correct code. MaxApplZone and MoveHHi were marked [Not in ROM] in Inside Macintosh, Volumes I-III . They are ROM calls in the 128K ROM. Since they are not in the 64K ROM, if you want your program to work on 64K ROM routines it is necessary to call the routines by a JSR to a glue (library) routine instead of using the actual trap macro. Name = TN.104.Globals from Asm Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.104.Globals from Asm Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.104.Globals from Asm - This technical note demonstrates how to access MPW Pascal and MPW C globals from the MPW Assembler. To allow access of MPW Pascal globals from the MPW Assembler, you need to identify the variables that you wish to access as external. To do this, use the {$Z+} compiler option. Using the {$Z+} option can substantially increase the size of the object file due to the additional symbol information (no additional code is generated and the symbol information is stripped by the linker). Name = TN.105.Object Pascal Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.105.Object Pascal Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.105.Object Pascal - Object Pascal must have a CODE segment named %_MethTables in order to access object methods. In MacApp this is taken care of “behind the scenes” so you don’t have to worry about it . However, if you are doing a straight Object Pascal program, you must make sure that %_MethTables is around when you need it. If it’s unloaded when you call a method, your Macintosh will begin executing wild noncode and die a gruesome and horrible death. Name = TN.106.VCBs and Drive #s Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.106.VCBs and Drive #s Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.106.VCBs and Drive #s - The top of page IV-178 in The File Manager chapter of Inside Macintosh in attempts to explain the behavior of two fields in a volume control block when the corresponding disk is offline or ejected. Due to the fact that a little bit is left unsaid, this paragraph is rather misleading. The two fields in question are vcbDrvNum and vcbDRefNum (referred to as ioVDrvInfo and ioVDRefNum in C and Pascal). PBHGetVInfo can be used to access these fields. Name = TN.107.Nulls in Filenames Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.107.Nulls in Filenames Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.107.Nulls in Filenames - Some applications (loosely speaking so as to include Desk Accessories, INITs, and what-have-you) generate or rename special files on the fly so that they are not explicitly named by the user via SFPutFile. Since the Macintosh file system is very liberal about filenames and only excludes colons from the list of acceptable characters, this can lead to some difficulties, both for the end user and for writers of other programs which may see these files. Name = TN.108.AddDrive DrvrInstall and Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.108.AddDrive DrvrInstall and Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.108.AddDrive DrvrInstall and - AddDrive, _DrvrInstall, and _DrvrRemove are used in the sample SCSI driver in the SCSI Development Package, which is available from APDA. This Technical Note documents the parameters for these calls. Changes since March 1, 1988: Updated the _DrvrInstall text to reflect the use of register A0, which should contain a pointer to the driver when called. Also added simple glue code for _DrvrInstall and _DrvrRemove since none is available in the MPW interfaces. Name = TN.109.Bug in MPW 1.0 Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.109.Bug in MPW 1.0 Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.109.Bug in MPW 1.0 - This note formerly described a problem in the language libraries for MPW 1.0. This bug is fixed in MPW 1.0.2, available from APDA. Name = TN.110.MPW Stand-Alone Code Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.110.MPW Stand-Alone Code Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.110.MPW Stand-Alone Code - This Technical Note formerly discussed using MPW Pascal and C to write stand-alone code, such as 'WDEF', 'LDEF', 'INIT', and 'FKEY' resources. Changes since February 1990: Merged the contents of this Note into Technical Note #256, Stand-Alone Code, ad nauseam.This Note formerly discussed using MPW Pascal and C to write stand-alone code. This information has been expanded and is now contained in Technical Note #256, Stand-Alone Code, ad nauseam. Name = TN.111.MoveHHi/SetResPurge Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.111.MoveHHi/SetResPurge Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.111.MoveHHi/SetResPurge - SetResPurge(TRUE) is called to make the Memory Manager call the Resource Manager before purging a block specified by a handle. If the handle is a handle to a resource, and its resChanged bit is set, the resource data will be written out (using WriteResource). Name = TN.112.FindDItem Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.112.FindDItem Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.112.FindDItem - FindDItem is a potentially useful call which returns the number of a dialog item given a point in local coordinates and a dialog handle. It returns an item number of –1 if no item’s rectangle overlaps the point. This is all well and good, except you don’t get back quite what you would expect. Name = TN.113.Boot Blocks Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.113.Boot Blocks Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.113.Boot Blocks - There are two undocumented features of the Boot Blocks. This note will describe how they currently work. Warning: The format and functionality of the Boot Blocks will change in the future; dependence on this information may cause your program to fail on future hardware or with future System software. Name = TN.114.AppleShare/Old Finder Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.114.AppleShare/Old Finder Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.114.AppleShare/Old Finder - A rumor has been spread that if you use a pre-AppleShare Finder on a workstation to access AppleShare volumes, you can bypass AppleShare’s “access privilege” mechanisms. Name = TN.115.Stationery Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.115.Stationery Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.115.Stationery - With the introduction of AppleShare (Apple’s file server) there are restrictions on self-modification of application resource files and the placement of configuration files. This note describes one way to get around the necessity for configuration files. Name = TN.116.SharingApps Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.116.SharingApps Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.116.SharingApps - Normally, applications on an AppleShare server volume cannot be executed by more than one user at a time. This technical note explains why, and tells how you can enable your application to be shared. Name = TN.117.Compatibility Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.117.Compatibility Size: 48K Date: 2/15/91 Version: AMUG file information and description: TN.117.Compatibility - While creating or revising any program for the Macintosh, you should be aware of the most common reasons why programs fail on various versions of the Macintosh. This note will detail some common failure modes, why they occur, and how to avoid them. Name = TN.118.Printing Errors Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.118.Printing Errors Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.118.Printing Errors - This Technical Note formerly described how to check and properly handle errors that occur during printing with the Printing Manager. Changes since March 1988: Merged contents into Technical Note #161. This Note formerly described how to check and properly handle Printing Manager errors. This information is now contained in Technical Note #161, A Printing Loop That Cares…, which also includes a table of Printing Manager error codes. Name = TN.119.Color QuickDraw? Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.119.Color QuickDraw? Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.119.Color QuickDraw? - This note formely described a way to determine if Color QuickDraw is present on a particular machine. We now recommend that you call SysEnvirons to find out, as described in Technical Note #129. Name = TN.120.Off-Screen Pixel Map Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.120.Off-Screen Pixel Map Size: 15K Date: 2/15/91 Version: AMUG file information and description: TN.120.Off-Screen Pixel Map - This Technical Note provides a simple example of drawing to, then copying from, an off-screen pixel map. Changes since October 1988: Made changes to the code which convert GDevice color look-up tables (clut) to pixel map color look-up tables so _CopyBits will copy the color information correctly. This information is especially important for color printing. Name = TN.121.AppleTalk Interfaces Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.121.AppleTalk Interfaces Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.121.AppleTalk Interfaces - What you need to do in order to use high-level AppleTalk routines depends upon the interfaces you are using. Some differences are outlined below. Name = TN.122.Dev.-Ind. Printing Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.122.Dev.-Ind. Printing Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.122.Dev.-Ind. Printing - The Printing Manager was designed to give Macintosh applications a device- independent method of printing, but we have provided device-dependent information, such as the contents of the print record. Due to the large number of printer-type drivers becoming available (even for non-printer devices) device independence is more necessary than ever. What this means to you, as a developer, is that we will no longer be providing (or supporting) information regarding the internal structure of the print record. Name = TN.123.LaserWriter ROM Bugs Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.123.LaserWriter ROM Bugs Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.123.LaserWriter ROM Bugs - These are LaserWriter bugs that your users may encounter when printing from any Macintosh application. These are for your information; you cannot code around them. The bugs described here occur in the 1.0 and 2.0 LaserWriter ROMs. Name = TN.124.Low-Level Printing Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.124.Low-Level Printing Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.124.Low-Level Printing - When you use the low-level printer driver to print, you don’t get the benefits of the error checking that is done when you use the high-level Printing Manager. So, if the user prints to an AppleTalk ImageWriter (including an AppleTalk ImageWriter LQ) that is busy printing another job, the driver doesn’t know whether the printer is busy, offline, or disconnected. Because of this, PrError will return (and PrintErr will contain) abortErr. Name = TN.125.Spool/Print Shared Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.125.Spool/Print Shared Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.125.Spool/Print Shared - This technical note discusses drawbacks of using the spool-a-page/ print-a-page method of printing. The “spool-a-page/print-a-page” method of printing prints each page of a document as a separate job instead of calling PrPicFile to print the entire picture file. Many applications adopted this method of printing to avoid running out of disk space while the ImageWriter driver was spooling the document to disk. Name = TN.126.Sub(Launching) H-L Lang Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.126.Sub(Launching) H-L Lang Size: 14K Date: 2/15/91 Version: AMUG file information and description: TN.126.Sub(Launching) H-L Lang - Note: Developer Technical Support takes the view that launching and sublaunching are features which are best avoided for compatibility (and other) reasons, but we want to make sure that when it is absolutely necessary to implement it, it is done in the safest possible way. This Technical Note discusses the “safest” method of calling _Launch from a high-level language that supports inline assembly language with the option of launching or sublaunching another application. Name = TN.127.TextEdit EOL Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.127.TextEdit EOL Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.127.TextEdit EOL - TESetSelect may be used to position the insertion point at the end of a line. There is an ambiguity, though; should the insertion point appear at the end of the preceding line or the start of the following one? It is possible to determine what will happen, as you are about to see. Name = TN.128.PrGeneral Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.128.PrGeneral Size: 15K Date: 2/15/91 Version: AMUG file information and description: TN.128.PrGeneral - The Printing Manager architecture has been expanded to include a new procedure called PrGeneral. The features described here are advanced, special-purpose features, intended to solve specific problems for those applications that need them. The calls to determine printer resolution introduce a good deal of complexity into the application’s code, and should be used only when necessary. Name = TN.129._Gestalt & _SysEnvirons Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.129._Gestalt & _SysEnvirons Size: 9K Date: 2/15/91 Version: AMUG file information and description: Tech Note 129, _Gestalt & _SysEnvir Copyright(C)1990 Apple Computer. This Technical Note discusses latest changes and enhancements in the _Gestalt and _SysEnvirons calls. Changes since June 1990: Added new machine and keyboard constants for _SysEnvirons and also added a section on new selectors and response values for _Gestalt. Previous versions of this Note provided the latest documentation on new information the _SysEnvirons trap could return. DTS will continue to revise this Note to provide this information; however, as the _Gestalt trap is now the preferred method for determining information about a machine environment, this Note will also provide up-to-date information on _Gestalt selectors. Name = TN.130.ioCompletion Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.130.ioCompletion Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.130.ioCompletion - When making synchronous calls to the File Manager, it is not necessary to clear ioCompletion field of the parameter block, since that is done for you. Some earlier technotes explicitly cleared ioCompletion, with the knowledge that this was unnecessary, to try to encourage developers to fill in all fields of parameter blocks as indicated in Inside Macintosh. By the way, this is true of all parameter calls—you only have to set fields that are explicitly required. Name = TN.131.TextEdit Bugs in 4.2 Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.131.TextEdit Bugs in 4.2 Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.131.TextEdit Bugs in 4.2 - This note formerly described the known bugs with the version of Styled TextEdit that was provided with System 4.1. Many of these bugs were fixed in System 4.2. This updated Technical Note describes the remaining known problems. TEStylInsert - Calling TEStylInsert while the TextEdit record is deactivated causes unpredictable results, so make sure to only call TEStylInsert when the TextEdit record is active. Name = TN.132.AppleTalk Interfaces Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.132.AppleTalk Interfaces Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.132.AppleTalk Interfaces - Technical Note #121 announced that we would be moving to a simplified AppleTalk Manager interface. That interface is available now, as part of MPW 2.0 and newer. Documentation for this new interface is contained in the AppleTalk Manager chapter of Inside Macintosh Volume V. This technical note contains some of the preliminary documentation for this interface and some useful points about information about it, and AppleTalk in general. Name = TN.133.Is This a Spooler? Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.133.Is This a Spooler? Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.133.Is This a Spooler? - When the LaserShare spooler is on an AppleTalk network, it acts like a LaserWriter-type device, which can be chosen and communicated with much like a real LaserWriter. Some applications, however, must communicate with a LaserWriter directly, not a spooler. If this is true for your application, you can check whether you are actually talking to a real LaserWriter by sending to the LaserWriter the following query: Name = TN.134.Boot problems Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.134.Boot problems Size: 26K Date: 2/15/91 Version: AMUG file information and description: TN.134.Boot problems - The death of a hard disk with megabytes worth of data can be exceedingly traumatic. This technical note will describe techniques for recovering a hard disk and the data that is on it. The discussion will also include some tips on how to avoid problems. Name = TN.135.Getting thru CUSToms Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.135.Getting thru CUSToms Size: 27K Date: 2/15/91 Version: AMUG file information and description: TN.135.Getting thru CUSToms - This technical note provides a way for developers to allow sophisticated users to add code to an off-the-shelf application. Using this scheme, the user can easily install the code module; the application has to know how to call it and, optionally, be able to respond to a set of predefined calls from the custom package. Name = TN.136.A5 & GrowZone Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.136.A5 & GrowZone Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.136.A5 & GrowZone - If you have a grow zone function, it may get called when a system routine is trying to allocate memory. Because this can happen, you can’t be guaranteed that register A5 will be correct. If your grow zone function depends on A5, you should save register A5, load A5 from the low-memory global CurrentA5 (a long word at $904), and restore the caller’s A5 before you exit. Name = TN.137.AppleShare 1.1 Bug Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.137.AppleShare 1.1 Bug Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.137.AppleShare 1.1 Bug - A bug has been discovered in AppleShare 1.1’s implementation of the AppleTalk Filing Protocol FPMove call. This bug only affects developers implementing custom workstation access code that will access AppleShare 1.1 servers from non-Macintosh systems (such as MS-DOS systems); if the guidelines below are not followed, data loss may result. Name = TN.138.KanjiTalk Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.138.KanjiTalk Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.138.KanjiTalk - This Technical Note describes the minor differences between using KanjiTalk with the Japanese Macintosh Plus and KanjiTalk with a standard Macintosh Plus. Name = TN.139.Macintosh Plus ROMs Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.139.Macintosh Plus ROMs Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.139.Macintosh Plus ROMs - Readers Digest condensed version of Macintosh Plus ROM history, or the truth according to Bo3bdar the everpresent: 1st version (Lonely Hearts, checksum 4D 1E EE E1): Bug in the SCSI driver; won’t boot if external drive is turned off. We only produced about one and a half months worth of these. 2nd version (Lonely Heifers, checksum 4D 1E EA E1): Fixed boot bug. This version is the vast majority of beige Macintosh Pluses. Name = TN.140.PBHSetVol Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.140.PBHSetVol Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.140.PBHSetVol - This note explains PBHSetVol, and why its use is not recommended. PBHSetVol, like SetVol and PBSetVol, allows you to set the current default volume and directory to be used with subsequent File Manager calls. Unlike SetVol and PBSetVol, though, PBHSetVol lets you specify the volume and the directory separately, using the ioVRefNum and ioWDDirID fields. Name = TN.141.Number of Resources Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.141.Number of Resources Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.141.Number of Resources - This note describes the limitation of the number of resources in a single resource file. There is a limit to the number of the resources in a single resource file. This limitation is imposed by the resource map. There are two bytes at the end of the resource map which are the offset from the beginning of the resource map to the beginning of the resource names list. Name = TN.142.Network Events Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.142.Network Events Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.142.Network Events - Future System software enhancements will not support network events. This note gives hints on weaning your application from the use of network events. Name = TN.143.Don’t Call ADBReInit Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.143.Don’t Call ADBReInit Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.143.Don’t Call ADBReInit - Because of a bug (which causes auto-repeat) in the ROM version of the Macintosh SE keyboard driver, a patch was placed in System 4.1. If ADBReInit is called, the ROM version of the keyboard driver will be reloaded, and the RAM version of the driver with the patches will not be used. Therefore, it is recommended that ADBReInit not be called on the Macintosh SE until the problem is fixed. (There is no need to call ADBReInit.) This problem will not occur with the Macintosh II ROM version of the keyboard driver. Name = TN.144.Color Monitor Connection Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.144.Color Monitor Connection Size: 8K Date: 5/18/91 Version: AMUG file information and description: #144 - Macintosh Color Monitor Connections. Revised by Jim Luther & Wayne Correia February 1991. Written by Mark Baumwell July 1987. This Technical Note describes how to connect the Macintosh II Video Card, Macintosh IIci built-in video, and Macintosh LC video to third-party monitors. Changes since February 1990 - Added pinout description for the Macintosh LC external video connector and a Macintosh LC to VGA monitor adapter cable. Standardized signal names throughout Note. Name = TN.145.Debugger FKEY Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.145.Debugger FKEY Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.145.Debugger FKEY - This Technical Note formerly discussed showed how to write an 'FKEY' to trap to the debugger. Changes since March 1988: Merged the contents of this Note into Technical Note #256, Stand-Alone Code, ad nauseam. This Note formerly showed how to write an 'FKEY' resource to trap to the debugger. This information is now an example of writing stand-alone code resources in Technical Note #256, Stand-Alone Code, ad nauseam. Name = TN.146.MPW’s -mc68881 Option Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.146.MPW’s -mc68881 Option Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.146.MPW’s -mc68881 Option - This Technical Note discusses MPW’s -mc68881 option, which represents Extended values in 96 bits (instead of 80, as with software SANE), and compatibility issues when using non-SANE system calls that expect 80-bit Extended values. Changes since March 1988: Added a warning to explicitly check for the presence of an FPU if an application uses floating point instructions and removed a sentence which implied that all Macintosh II-class machines would have built-in FPUs. Name = TN.147.Finder Notes Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.147.Finder Notes Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.147.Finder Notes - The Finder has undergone a couple of changes you should keep in mind when creating the “bundle” information for your application. Name = TN.148.Mac II Board Suppliers Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.148.Mac II Board Suppliers Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.148.Mac II Board Suppliers - This note lists suppliers of parts that may be helpful for Macintosh II board developers. If your company supplies these parts, but is not listed here, please send a message to us (at the address on Technical Note #0) and we’ll include you in the next revision of this technical note. Name = TN.149.Document Names Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.149.Document Names Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.149.Document Names - Our compatibility testing for LaserShare (Apple’s LaserWriter spooler) has turned up a number of applications that do not provide the Printing Manager with a document name; although this feature is not required, it is nice for users that share printers. Name = TN.150.SE Disk Driver Bug Path = AMUG CD:Files:MacTechNotes:TN.101.150:TN.150.SE Disk Driver Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.150.SE Disk Driver Bug - A bug in the Macintosh SE ROMs causes the top drive to be slower than the bottom one in two-drive machines. This bug is fixed in System 4.2 and newer. Name = TN.151.System Error 33 Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.151.System Error 33 Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.151.System Error 33 - System 3.2 introduced a new system error, ID=33, generated by the Memory Manager when it notices that a heap had been corrupted in a certain way. This error is listed in the file “SysErr.a” as “negZcbFreeErr”. Name = TN.152.Laser Prep Routines Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.152.Laser Prep Routines Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.152.Laser Prep Routines - This technical note addresses the issues involved in depending on the procedures and constants defined in the Laser Prep dictionary. Name = TN.153.New IU Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.153.New IU Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.153.New IU - The International Utilities package and the international resources have been changed with System file 4.1 to take advantage of the Script Manager. Name = TN.154.Large PICT Files Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.154.Large PICT Files Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.154.Large PICT Files - Now that we have scanners and other massive-picture producing types of applications, there is a need to address the problem of how to display a PICT format object that is bigger than a current PICT resource is allowed to be. Note that this technique applies equally well to version 1 and version 2 (word-opcode) pictures as produced by the Macintosh II. Name = TN.155.Handles vs. Pointers Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.155.Handles vs. Pointers Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.155.Handles vs. Pointers - A handle is a handle and a pointer is a pointer. Applications should avoid embedding non-relocatable objects (that the system assumes will never move) in handles. Name = TN.156.Identifying Features Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.156.Identifying Features Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.156.Identifying Features - This technical note explains how to check at run time to see if specific functionality, such as the “new” TextEdit, is present. Name = TN.157.Problem with GetVInfo Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.157.Problem with GetVInfo Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.157.Problem with GetVInfo - The high-level call GetVInfo (and its low-level counterpart PBGetVInfo) may return inaccurate results for freeBytes when running HFS. The high-level File Manager call GetVInfo returns the number of free bytes on a volume as one of its parameters. Name = TN.158.MultiFinder Questions Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.158.MultiFinder Questions Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.158.MultiFinder Questions - This technical note provides answers to some of the more frequently asked questions about MultiFinder. The development name for MultiFinder was Juggler, so the term “juggle” is used in this technical note to denote a context switch. Name = TN.159.Hard Disk Hacking Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.159.Hard Disk Hacking Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.159.Hard Disk Hacking - For those of a technical bent with some extra time, you can build your own hard disk system from a cheap SCSI drive and a driver that you write. This is not a project for those short on time, so beware. Name = TN.160.Key Mapping Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.160.Key Mapping Size: 13K Date: 5/18/91 Version: AMUG file information and description: #160 - Key Mapping. Revised by Jim Luther, Peter Edberg, & Imran Sayeed February 1991. Written by Cameron Birse September 1987. This Technical Note describes the Macintosh family key code mapping scheme when running System file 4.1 and later. This Note also provides a “safe” method for remapping keyboards. Changes since October 1990 - Added a section on how 'KMAP' resources are matched to specific ADB keyboard types and a section on the original Macintosh and Macintosh Plus keyboards. Name = TN.161.Printing Loop That Cares Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.161.Printing Loop That Cares Size: 16K Date: 2/15/91 Version: AMUG file information and description: TN.161.Printing Loop That Cares - This Technical Note discusses opening and closing the Printing Manager with calls to _PrOpen and _PrClose as well as how to handle errors at print time. Changes since October 1989: Added the section on error checking, incorporating the error code descriptions formerly found in Technical Note #72, Optimizing For The LaserWriter—Techniques and an updated version of the information formerly found in Technical Note #118, How To Check and Handle Printing Errors. Name = TN.162.MPW 2.0 Pascal Bug Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.162.MPW 2.0 Pascal Bug Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.162.MPW 2.0 Pascal Bug - This note formerly described a bug in the MPW 2.0 Pascal compiler. This bug has been fixed in MPW 2.0.2. Name = TN.163.Colorizing CopyBits Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.163.Colorizing CopyBits Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.163.Colorizing CopyBits - Inside Macintosh Volume V states that the foreground and background colors are applied to an image during a CopyBits or CopyMask call. Accidental use of this feature can create bizarre coloring effects. This note explains what happens, how to avoid problems, and how to use it. Name = TN.164.MPW C Functions Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.164.MPW C Functions Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.164.MPW C Functions - Here’s the low-down on when C functions need not be declared in include files. “The include files are all screwed up!” This is a common misconception people have when they look through the MPW C include files. People report that the declaration of a ROM or system call foo() has been mistakenly left out of this or that include file. Here’s the low-down on when functions do not have to be declared in an include file. Name = TN.165.AS Drop Folder Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.165.AS Drop Folder Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.165.AS Drop Folder - This technical note outlines the steps an application must take to create files inside AppleShare drop folders. The AppleShare File Server allows the creation of drop folders. These are folders for which the user has the Make Changes privilege (write access), but not See Files (read access) or See Folders (search access). For an application to create a file in such a folder, the following procedure must be executed in strict order: Name = TN.166.C Glue Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.166.C Glue Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN. 166.C Glue - MPW 2.0 includes new C interfaces to ROM routines which no longer do string and point conversions. These new interfaces are described here. In MPW prior to 2.0, the C interfaces to Macintosh OS and Toolbox routines that had strings or points as arguments required following these rules 1. Strings must be passed as C strings (null terminated). 2. Points must be passed by address. Name = TN.167.AS Foreground Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.167.AS Foreground Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.167.AS Foreground - This technical note outlines the requirements and restrictions of an AppleShare foreground application. This information pertains to AppleShare versions 1.1 and newer. An AppleShare server requires a dedicated Macintosh. The server, however, is implemented as an interrupt-driven application that runs in the system heap of the server machine. Name = TN.168.HyperCard and You Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.168.HyperCard and You Size: 17K Date: 5/18/91 Version: AMUG file information and description: #168 HyperCard And You - This Technical Note describes some HyperCard anomalies with which developers should be familiar when developing stackware, and it documents differences between HyperCard versions where appropriate. Changes since November 1987 - Consolidated Technical Notes 168, HyperCard 'snd ' Resources; 169, HyperCard 1.0.1 and 1.1 Anomalies; and 170, HyperCard File Format while adding and updating material with regard to HyperCard 2.0 and condensing or obsoleting information on bugs which have been addressed. Name = TN.169.HyperCard Anomalies Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.169.HyperCard Anomalies Size: 4K Date: 5/18/91 Version: AMUG file information and description: #169 HyperCard 1.0.1 And 1.1 Anomalies. Revised by Jeremy J. Bornstein, death dwarf of minraud February 1991. Written by Chris Knepper November 1987. This Technical Note formerly described some HyperCard anomalies between HyperCard 1.0.1 and 1.1. Changes since March 1988. Merged contents into Technical Note #168, HyperCard And You: Economy Edition. Name = TN.170.HyperCard Format Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.170.HyperCard Format Size: 4K Date: 5/18/91 Version: AMUG file information and description: #170 HyperCard File Format. Revised by jeremy j. bornstein, death dwarf of minraud February 1991. Written by Chris Knepper November 1987 This Technical Note formerly discussed the proprietary nature of the HyperCard file format and Apple’s policy not to license it. Changes since March 1988: Merged contents into Technical Note #168, HyperCard And You Economy Edition. This Note formerly discussed the proprietary nature of the HyperCard file format and Apple’s policy not to license it. This information has been updated for HyperCard 2.0 under Claris and integrated into Technical Note #168, HyperCard And You - Economy Edition. Name = TN.171._PackBits Data Format Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.171._PackBits Data Format Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.171._PackBits Data Format - This Technical Note describes the format of data packed by the Toolbox utility _PackBits. Although you can simply unpack these files using the _UnPackBits call, we provide this information here for the terminally curious and for those manipulating MacPaint documents or PICT files by hand. Warning: This information is subject to change. Changes since March 1988: Added information on PICT files which contain data from the _PackBits routine. Name = TN.172.Popup MDEF Message Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.172.Popup MDEF Message Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.172.Popup MDEF Message - In order to support popup menus, menu definition procedures (MDEFs) must now respond to a new message, mPopupMsg. mPopupMsg is message number 3. When your MDEF is called with this message, it should calculate the rectangle in which the popup menu should appear. Name = TN.173.PrGeneral Bug Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.173.PrGeneral Bug Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.173.PrGeneral Bug - This technical note documents a bug in the implementation of the PrGeneral procedure in the LaserWriter driver version 4.0. The bug has to do with the format of the information returned by the GetRslData opcode. This technical note will also describe a workaround for the problem. Name = TN.174.PrintAction Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.174.PrintAction Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.174.PrintAction - This technical note describes how Print Drivers can access the Script Manager Print Action routine to print unconventional text, such as Japanese or Arabic. Name = TN.175.SetLineWidth Revealed Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.175.SetLineWidth Revealed Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.175.SetLineWidth Revealed - This technical note describes the internal implementation, and correct method of using, the SetLineWidth Picture Comment. The SetLineWidth picture comment provides a way of accessing PostScript’s 'setlinewidth' operator. Name = TN.176.Installing SIMMs ƒ.dd Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.176.Installing SIMMs ƒ.dd Size:101K Date: 2/15/91 Version: AMUG file information and description: Tech Note 176 - This Technical Note describes the different possible memory configurations of all models of the Macintosh family that use Single In-line Memory Modules (SIMMs) as well as the non-SIMM memory upgrade options of the Macintosh Portable and Macintosh Classic. (Special thanks to Brian Howard for the Macintosh Plus and original SE drawings, and for the inspiration for the other drawings.) This Note also describes the obstacles to using four megabit (Mbit) DRAM SIMMs in Apple’s Macintosh products to date. Changes since June 1990, Added Macintosh Classic, LC, and IIsi configurations. Name = TN.177.WNE Bug/1.0 Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.177.WNE Bug/1.0 Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.177.WNE Bug/1.0 - This Technical Note discusses a bug in WaitNextEvent in MultiFinder 1.0. This bug only occurs when WaitNextEvent is called from the background. This bug will be fixed in the next release of MultiFinder. Change since 11/87: the bug will be fixed in Systems with versions greater than $04FF. Name = TN.178.Sorting Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.178.Sorting Size: 17K Date: 2/15/91 Version: AMUG file information and description: TN.178.Sorting - This technical note describes how to modify the standard string comparison by constructing an itl2 resource. Developers may want to modify the standard string comparison if Apple’s comparison doesn’t meet their needs or if Apple has not written a string comparison routine for the language that concerns them. Name = TN.179.ioNamePtr Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.179.ioNamePtr Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.179.ioNamePtr - It is very important to set ioNamePtr when making PB calls, even if you don’t want those calls to return a name. Whenever Inside Macintosh indicates that ioNamePtr is either required for input or returns something, you must set ioNamePtr to either nil (if you aren’t using a name) or to point to storage for a Str255. If you don’t explicitly set ioNamePtr, strange and unusual crashes may occur, depending on the machine/configuration your code is run on. Name = TN.180.MultiFinder Miscellanea Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.180.MultiFinder Miscellanea Size: 24K Date: 2/15/91 Version: AMUG file information and description: TN.180.MultiFinder Miscellanea - This Technical Note discusses MultiFinder issues of which programmers should be aware. Changes since June 1988: Updated and generalized sample code to reflect new MPW 3.0 calls in both C and Pascal for saving and restoring A5 for interrupt code that accesses application globals. Removed text that can be found in Programmer’s Guide to MultiFinder, and added a note about _PostEvent. Name = TN.181.Picture Comments Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.181.Picture Comments Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.181.Picture Comments - Application-specific picture comment conflict and registration is addressed, along with Developer Technical Support’s method for solving it. I will assume that the nature and usefulness of picture comments are already well known. Name = TN.182.WordBreak Tables Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.182.WordBreak Tables Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.182.WordBreak Tables - This technical note describes how to construct auxiliary break tables for use with the FindWord routine in the Script Manager. Constructing break tables - The FindWord algorithm finds word boundaries by determining where words should not be broken. For example, “re-do” is one word: it should not be broken at the hyphen. In other words, a sequence of the form: (letter, hyphen, letter) should not be broken between the first and second or second and third character. Name = TN.183.Position ind PS Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.183.Position ind PS Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.183.Position ind PS - This technical note describes a method for inserting position-independent PostScript into QuickDraw pictures. There is a problem with pictures that contain PostScript code. Sometimes the PostScript code that is inserted into the picture is dependent on the position of the picture on the page. The problem arises when these pictures are cut or copied from their original position, and pasted into another position or even into another document. The PostScript code will not know the new location of the picture, and will not execute correctly. Name = TN.184.Notification Manager Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.184.Notification Manager Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.184.Notification Manager - This Technical Note describes the Notification Manager, the part of the operating system that lets an application, desk accessory, or driver alert the user. Changes since October 1989: Clarified the section on error handling for calls to _NMInstall. Name = TN.185.OpenRFPerm Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.185.OpenRFPerm Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.185.OpenRFPerm - This note corrects an error in the description of the Resource Manager routine OpenRFPerm found in Inside Macintosh Volume IV. Name = TN.186.Lock, Unlock the Range Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.186.Lock, Unlock the Range Size: 8K Date: 5/18/91 Version: AMUG file information and description: #186 - Lock, Unlock the Range. This Technical Note discusses the _PBLockRange and _PBUnlockRange routines; how they act on local and shared volumes and why you should not set the ioPosMode field to fsFromLEOF in the parameter block for those routines when accessing a file on an AppleShare volume. Changes since April 1988: Added information on how _PBLockRange and _PBUnlockRange really work. Name = TN.187.ioPosOffset Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.187.ioPosOffset Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.187.ioPosOffset - The Device Manager chapter of Inside Macintosh Volume II says that ioPosOffset is passed to and returned by Read and Write calls. It also says that “After the read [or write] is completed, the position is returned in ioPosOffset…” Actually, ioPosOffset is not changed by either call. Also note that device drivers should only look at the dCtlPosition field of the DCE, and should not look directly at the ioPosOffset field of the parameter block. The Device Manager sets up dCtlPosition for the driver, taking into account both the ioPosMode and the ioPosOffset. Name = TN.188.ChangedResource Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.188.ChangedResource Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.188.ChangedResource - The toolbox trap ChangedResource is used to inform the Resource Manager that the contents of a resource have changed and should be written to disk. The actual write occurs on the next call to WriteResource (for the specific resource) or UpdateResFile (for the resource file containing the specified resource). When called, ChangedResource reserves enough disk space to contain the changed resource. A little-known “feature” of ChangedResource is that it reserves disk space every time it is called. Name = TN.189.Version Territory Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.189.Version Territory Size: 13K Date: 2/15/91 Version: AMUG file information and description: TN.189.Version Territory - This Technical Note describes the 'vers' resource supported by Finder 6.1 and later. Changes since October 1988: Changed MPW C code to reflect the changes in MPW C 3.1. Finder 6.1 introduced a feature which allows the creator of a file to identify the version of that file as well as the version of a set of files which includes that file. These version numbers are stored in 'vers' resources, and each contains a BCD form of the version number and a longer version message (which the Finder displays in the Get Info window for each file). Name = TN.190.WDs & MultiFinder Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.190.WDs & MultiFinder Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.190.WDs & MultiFinder - This technical note describes the way that working directories are handled under MultiFinder. Some versions of Technical Note #77 claim that you can open working directories with a unique ioWDProcID and that they will only be deallocated when “the system is rebooted.” Name = TN.191.Font Names Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.191.Font Names Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.191.Font Names - This note recommends the use of font names rather than font numbers. The Font Manager chapter of Inside Macintosh Volume IV claims that font family numbers 0 through 127 are reserved for use by Apple, and numbers 128 through 255 are assigned by Apple for fonts created by software developers. This is no longer true. Developer Technical Support does not assign font family numbers. You should only use font numbers to reference the system font (font 0) and application default font (font 1). All other fonts should be identified by name. The Font/DA Mover will renumber a font when moving it into a file containing a conflicting font family. Name = TN.192.Surprises in LW 5.0 Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.192.Surprises in LW 5.0 Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.192.Surprises in LW 5.0 - This Technical Note describes some changes in version 5.0 and later LaserWriter drivers. Changes since April 1988 - Described a bug in 5.x which is fixed in 6.0 and later, and reiterated a warning about storing fonts in an application. With the release of LaserWriter 5.0 and background printing, a few changes had to be made to the LaserWriter driver. Although these changes were transparent to most applications, some have had problems. Most of these problems are related to use of unsupported features. This Note details a partial list of the changes. Name = TN.193.So Many Bitmaps… Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.193.So Many Bitmaps… Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.193.So Many Bitmaps… - This Technical Note discusses the routine BitMapToRegion, which converts a bitmap to a region, and is available in the 32-Bit QuickDraw INIT and from Apple Software Licensing. Changes since October 1989: Added trap definitions for developers using the 32-Bit QuickDraw version of this routine without the correct MPW include file. Name = TN.194.WMgrPortability Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.194.WMgrPortability Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.194.WMgrPortability - Where WMgrPort (the Window Manager’s port), MultiFinder, and drawing outside of one’s windows will be reconciled. Beware - Drawing outside of windows from within an application is guaranteed to make that application less compatible with future systems. In order to be as MultiFinder compatible as possible, draw only in response to an update event or as part of the feedback for a user action, i.e. while tracking the mouse. MultiFinder compatibility is just as important as HFS compatibility! Name = TN.195.ASP & AFP Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.195.ASP & AFP Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.195.ASP & AFP - The descriptions of the AppleTalk Session Protocol and AppleTalk Filing Protocol functions within the body of the AppleTalk Manager chapter are incorrect and conflict with those in the Summary of the AppleTalk Manager. This technical note resolves the discrepancy. Name = TN.196.CDEF Params and Bugs Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.196.CDEF Params and Bugs Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.196.CDEF Params and Bugs - This Technical Note describes known bugs in the Control Manager which affect control definition functions ('CDEF' resources). Changes since August 1988: Updated to reflect known bugs in the posCntl and thumbCntl messages and the Control Manager _TrackControl call. Name = TN.197.Chooser PACK Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.197.Chooser PACK Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.197.Chooser PACK - Beginning with version 3.2, the Chooser has been enhanced to provide support for additional controls. As stated in Inside Macintosh IV-217, the Chooser communicates with device packages as if they were the following function: Name = TN.198.NFNTs Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.198.NFNTs Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.198.NFNTs - Font/DA Mover version 3.8 (shipped with System 6.0) incorporates support for 'NFNT' resources and styled font family members. This note discusses several issues concerning the arrangement of font-related resources and their IDs. It also documents the proper arrangement of font resources within the font files that Font/DA Mover uses. Name = TN.199.KillNBP Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.199.KillNBP Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.199.KillNBP - This technical note clears up some confusion regarding the Name Binding Protocol KillNBP function. The description of the PKillNBP function on page 519 of Inside Macintosh Volume V is somewhat confusing. The data type of the parameter thePBptr is incorrectly given as ATPPBPtr and the pointer to the queue element from the NBP call to be aborted is incorrectly given as being passed in aKillQEl. The following is a correct description of the KillNBP function: Name = TN.200.MPW 2.0.2 Bugs Path = AMUG CD:Files:MacTechNotes:TN.151.200:TN.200.MPW 2.0.2 Bugs Size: 27K Date: 2/15/91 Version: AMUG file information and description: TN.200.MPW 2.0.2 Bugs - This Technical Note describes latest information about bugs or unexpected “features” in the MPW C, Pascal, and Assembler products and the Toolbox and OS Interface Libraries. We intend this Note to be a complete list of all known bugs in these products, which will be updated as old bugs are fixed, or new ones appear. If you have encountered a bug or unexpected feature which is not described here, be sure to let us know. Specific code examples are useful. Name = TN.201.Read Packet Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.201.Read Packet Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.201.Read Packet - This technical note clears up some confusion concerning the low-level function ReadPacket. This function is called by protocol handlers and socket listeners. Name = TN.202.Resetting the Event Mask Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.202.Resetting the Event Mask Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.202.Resetting the Event Mask - In most cases, applications should not modify the system event mask, which means they should avoid calling SetEventMask and not alter the low-memory global SysEvtMask. Modifying the event mask is of no use to most applications, and the only situation in which an application might need to modify it is to detect key-up events. Only those developers creating applications which must detect key-up events need to know the information presented in this Technical Note. Other developers should avoid altering the system event mask at all costs. Name = TN.203.Managerial Abuse Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.203.Managerial Abuse Size: 13K Date: 2/15/91 Version: AMUG file information and description: TN.203.Managerial Abuse - When using the various pieces of the Macintosh operating system there is a temptation to try to stretch the built-in Managers too far. Developers should be aware of the intended purpose of the various Managers and beware of using them for things that they were not designed to handle. If extended beyond their design goals, they will become slow and unwieldy. Name = TN.204.HFS Tidbits Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.204.HFS Tidbits Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.204.HFS Tidbits - This Technical Note describes two poorly documented features of the File Manager. Always Set ioFVersNum to Zero - When making a File Manager call which uses a CInfoPBRec, or the fileParam or ioParam portion of either a ParamBlockRec or an HParamBlockRec, you should set the ioFVersNum field to zero. Name = TN.205.MultiFinder Revisited Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.205.MultiFinder Revisited Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.205.MultiFinder Revisited - This Technical Note describes several new features found in MultiFinder 6.0 and answers a few more commonly-asked questions. Changes since October 1989: Clarified the section on childDiedEvent events. How Can I Tell If MultiFinder is Present. Once again, you can’t. Previous Technical Notes discuss how to check for the new services available with MultiFinder (i.e., _WaitNextEvent and the temporary memory allocation calls). Name = TN.206.Space Aliens (ADB) Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.206.Space Aliens (ADB) Size: 19K Date: 2/15/91 Version: AMUG file information and description: TN.206.Space Aliens (ADB) - This Technical Note explains how the Apple Desktop Bus (ADB) works on the Macintosh. This Note covers the boot process, driver installation, ADB Manager run-time behavior, use of ADB Manager calls, and answers commonly asked questions. Changes since October 1989: Added a section on ADB Manager run-time behavior and removed the recommendation for using an 'INIT' resource or application-based installation procedure. Name = TN.207.Styled TextEdit 6.0 Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.207.Styled TextEdit 6.0 Size: 28K Date: 2/15/91 Version: AMUG file information and description: TN.207.Styled TextEdit 6.0 - Some changes were made to TextEdit in System 6.0 to provide more functionality and to make life easier for the programmer using TextEdit. This Note documents those changes and enhancements. Changes since August 1, 1988: Corrected an error in TEDispatchRec in the figure on page 8. Name = TN.208.Setting and Restoring A5 Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.208.Setting and Restoring A5 Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.208.Setting and Restoring A5 - The routines SetupA5 and RestoreA5 do not work properly when used with some optimizing Pascal and C compilers. Two new routines, SetCurrentA5 and SetA5, are available in MPW 3.0, and they should work with any compiler. Changes since December 1988. Removed the sample code and expanded the explanation of these two routines. The sample code in Technical Note #180 reflects these new A5 routines. Name = TN.209.CD ROM Formats Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.209.CD ROM Formats Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.209.CD ROM Formats - Generally, if a Macintosh has problems with a High Sierra disc, it’s because the disc in question doesn’t really conform to the High Sierra specification. There are actually two specifications of the High Sierra format. The Paper 28 May 1986 Working Paper for Information Processing — Volume and File Structure of Compact Read Only Optical Discs for Information Interchange (known as the “High Sierra” specification.) We’ll call discs conforming to this standard “High Sierra” discs. Name = TN.210.Desktop File Limits Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.210.Desktop File Limits Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.210.Desktop File Limits - There is a limit to the number of applications/files that the Finder can “see” on a single volume. This limitation is imposed by the Desktop file. The Desktop file is a resource file that the Finder uses to keep track of information about files and applications, including Finder file comments (Get Info comments), and how these files and applications relate to each other. Name = TN.211.Palette Manager Changes Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.211.Palette Manager Changes Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.211.Palette Manager Changes - This Technical Note describes the changes and enhancements to the Palette Manager in System Software 6.0.2 and future versions. Name = TN.212.Joy of 32-Bit Clean Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.212.Joy of 32-Bit Clean Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.212.Joy of 32-Bit Clean - What to do (and what not to do) to make your programs run under A/UX and future versions of the Macintosh System Software. Changes since October 1988. Added information on writing 32-bit clean CDEFs, and updated A/UX information to reflect the capabilities of A/UX 1.1. Name = TN.213._StripAddress Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.213._StripAddress Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.213._StripAddress - Inside Macintosh, Volume V, The OS Utilities, incorrectly documents the _StripAddress trap; this Technical Note correctly documents the trap and gives guidelines for its use. Changes since April 1990. Added a discussion of why the _StripAddress trap should be used under certain circumstances when patching traps. Name = TN.214.New Resource Mgr Calls Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.214.New Resource Mgr Calls Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.214.New Resource Mgr Calls - This Technical Note describes two new Resource Manager calls that make opening and creating resource files much easier. MPW 3.0 supplies glue routines for two new Resource Manager calls which provide new, easier ways of opening and creating resource files. Name = TN.215.“New” cdev Messages Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.215.“New” cdev Messages Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.215.“New” cdev Messages - This Technical Note describes some previously undocumented messages that the Control Panel can send to a Control Panel device (cdev). The Control Panel will send messages to a Control Panel device (cdev) in response to the user selecting the Undo, Cut, Copy, Paste and Clear items of the Edit menu. It will also send a message if the cdev contains a 'CURS' = –4064 resource. The following is a list of the previously undocumented messages, descriptions, and values: Name = TN.216.AppleShare Limits Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.216.AppleShare Limits Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.216.AppleShare Limits - This Technical Note describes some machine-dependent limits of current versions of AppleShare and AppleShare servers. The following chart lists some current AppleShare limits which are based upon the chosen server platform and memory configuration. The limits which otherwise might be present on a workstation are still in effect and are not affected by the workstation being logged into an AppleShare server. These limits will change in the future. Name = TN.217.Font File Icons Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.217.Font File Icons Size: 5K Date: 5/18/91 Version: AMUG file information and description: #217 Where Have My Font Icons Gone? Revised by Pete “Luke” Alexander April 1991. Written by Pete “Luke” Alexander December 1988. This Technical Note discusses why you should not link directly from your font files to the font icons provided by LaserWriter driver 5.2 and later. Changes since December 1988. Added some useful tips and described the method required to bundle an icon to your font file. Name = TN.218.New High-Level File Mgr Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.218.New High-Level File Mgr Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.218.New High-Level File Mgr - This Technical Note describes some new high-level File Manager calls that make dealing with the Hierarchical File System (HFS) easier. When the Hierarchical File System (HFS) was first introduced, a large number of low-level File Manager calls were documented. Unfortunately, higher-level equivalents to these calls were not present until now. The glue for these routines is built into MPW 3.0. They are provided as a convenience for those of you who hate filling in parameter blocks. Name = TN.219.New Memory Manager Glue Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.219.New Memory Manager Glue Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.219.New Memory Manager Glue - This Technical Note describes some new Memory Manager routines which make life a little easier for C and Pascal programmers. MPW 3.0 includes some new glue routines that allow you to allocate pre-zeroed handles and pointers and to allocate memory (zeroed or otherwise) in the system heap. These capabilities have always been available to assembly language programmers, but these routines make it possible for C and Pascal programmers to achieve the same results. Name = TN.220.Segment Loader Limits Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.220.Segment Loader Limits Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.220.Segment Loader Limits - This Technical Note discusses the jump table limitations of the Segment Loader and suggests some ways to work around these limitations to minimize the problem. These limitations are most evident to developers using MacApp and other object-oriented environments. Name = TN.221.NuBus Interrupt Latency Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.221.NuBus Interrupt Latency Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.221.NuBus Interrupt Latency - This Technical Note discusses NuBus™ interrupt latency, and why, contrary to popular belief, the Macintosh is not a real-time machine. Changes since December 1988: Changed sample code to defer cursor rendering to a deferred task rather than a “pseudo-VBL” task. Name = TN.222.Custom Menu Flashing Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.222.Custom Menu Flashing Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.222.Custom Menu Flashing - Selected menu items in a custom 'MDEF' resource do not flash correctly due to a bug in the Menu Manager. This Technical Note describes the problem and explains how to make your 'MDEF' flash correctly. Name = TN.223._InitGraph with MPW Asm Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.223._InitGraph with MPW Asm Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.223._InitGraph with MPW Asm - The Macintosh Programmer’s Workshop (MPW) requires assembly-language programmers to allocate their own QuickDraw global variables rather than use the default record as indicated in Inside Macintosh. Name = TN.224.Opening AppleTalk Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.224.Opening AppleTalk Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.224.Opening AppleTalk - This Technical Note describes the most effective, safe, and compatible way to open the AppleTalk drivers, .MPP and .ATP. The process of opening the AppleTalk drivers, .MPP and .ATP, can be greatly simplified. The AppleTalk Manager chapters of Inside Macintosh describe the calls MPPOpen and ATPLoad for use by high-level languages. They also describe the process of examining low-memory globals SPConfig and PortBUse before calling _Open for assembly language use of AppleTalk. Name = TN.225.Using RegisterName Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.225.Using RegisterName Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.225.Using RegisterName - The verify flag indicator byte (verifyFlag) of the AppleTalk RegisterName function should always be set TRUE in published code. The AppleTalk chapter of Inside Macintosh, Volume II-322, in describing the RegisterName function, states: Name = TN.226.Moving Your Cat Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.226.Moving Your Cat Size: 13K Date: 2/15/91 Version: AMUG file information and description: #226 Moving Your Cat Revised by John Harvey February 1991. This Technical Note clarifies the documentation in Inside Macintosh for _PBCatMove and provides a demonstration on how to use it. Changes since February 1989. Added a discussion of using NIL for the destination name pointer, which is the simplest way to use _CatMove, and revised the sample code to use the high-level File Manager calls. Thanks to Tim Dierks of Apple Developer Technical Support U.K. for pointing out the problems with the previous version of this Note. Name = TN.227.Toolbox Karma Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.227.Toolbox Karma Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.227.Toolbox Karma - This Technical Note discusses Macintosh Toolbox compatibility and what you can do to help the Macintosh continue evolving in the future. It is getting increasingly difficult to make additions to the Macintosh Toolbox. The single greatest obstacle today is compatibility. Often, engineering is prevented from doing something in an elegant manner because it would break some applications. This usually leaves three choices. Name = TN.228.Swapping MMU Mode Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.228.Swapping MMU Mode Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.228.Swapping MMU Mode - This Technical Note describes how to avoid crashing when swapping into 32-bit mode on a Macintosh II. Thanks to Jim Berry and Dan Weston for pointing this out. There is a condition where calling _SwapMMUMode to switch the Macintosh II into 32-bit mode can cause the system to crash. This condition happens in code which is loaded into memory from a resource, or is placed in memory that was allocated by the Memory Manager and is subsequently executed by using the master pointer as the address for a JSR instruction. This condition includes stand-alone, executable code resources (i.e., 'XCMD', 'XFCN', 'INIT', 'ADBS','FKEY', etc.), but does not apply to standard 'CODE' resources. Name = TN.229.A/UX Compatibility Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.229.A/UX Compatibility Size: 12K Date: 5/18/91 Version: AMUG file information and description: #229 A/UX 2.0 Compatibility Guidelines. Revised by Kent Sandvik & B. Winston Hendrickson. February 1991. Revised by B. Winston Hendrickson & Dave Radcliffe June 1990. Written by Dave Radcliffe April 1989. This Technical Note describes details of the A/UX 2.0 implementation of which developers should be aware, so that their Macintosh applications also work properly under A/UX. Changes since April 1989. This Note formerly described A/UX 1.1 Toolbox Bugs, but has been completely rewritten to cover A/UX 2.0 compatibility. Changes since June 1990. Changes due to A/UX 2.0.1, also added some new important issues. Name = TN.230.Macintosh SE/30 Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.230.Macintosh SE/30 Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.230.Macintosh SE/30 - This Technical Note discusses the Macintosh SE/30, items of interest to developers, and sources for further information. Changes since April 1989. Corrected an error in the addresses of the video display buffers. The Macintosh SE/30 is a modification of the original Macintosh SE concept. The SE/30 combines the modularity of the original SE with the capabilities of the larger Macintosh IIx. Although the name implies that the SE/30 borrows many characteristics from the SE, there are actually substantial differences between the two machines, and this Note addresses some of those differences. Name = TN.231.Allegro Common Lisp Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.231.Allegro Common Lisp Size: 16K Date: 2/15/91 Version: AMUG file information and description: TN.231.Allegro Common Lisp - This Technical Note describes some known problems and provides solutions to these problems for the Macintosh Allegro Common Lisp™ package which is available from Apple Computer, Inc. You should note, however, that although Apple acquired Coral Software and is selling Macintosh Allegro Common Lisp, Apple is not currently distributing any other products which had been developed or previously sold by Coral Software. Name = TN.232.Strip _OpenResFile... Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.232.Strip _OpenResFile... Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.232.Strip _OpenResFile...- This Technical Note discusses a bug in _OpenResFile and _OpenRFPerm which can cause system crashes and what you can do to avoid this problem. The traps _OpenResFile and _OpenRFPerm call some common code in 128K and later ROMs which was affected by some system patches for early print drivers. The problem is that the common code checks an attribute bit in the pointer to the string name to see if it is a dereferenced handle. Name = TN.233.MF and _SetGrowZone Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.233.MF and _SetGrowZone Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.233.MF and _SetGrowZone - MultiFinder gives each application its own heap in which to run. Because it wants to do some fairly tricky memory management, MultiFinder installs its own grow zone procedure (gzProc) in the application heap, and patches _SetGrowZone to store your application’s gzProc in a temporary variable inside of itself. Name = TN.234.NuBus Physical Designs Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.234.NuBus Physical Designs Size: 23K Date: 2/15/91 Version: AMUG file information and description: TN.234.NuBus Physical Designs - This Technical Note discusses the possible problems you might run into while designing a NuBus™ card. It covers some of the specifications which, if not followed, will have problems with current Macintosh machines, and possibly future machines. Changes since June 1989. Added warnings about the no component area and full-size NuBus cards. Name = TN.235.Coop with Coprocessor Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.235.Coop with Coprocessor Size: 7K Date: 2/15/91 Version: AMUG file information and description: TN.235.Coop with Coprocessor - The use of the 68881 or 68882 coprocessor is usually handled by the SANE package or by a development system’s libraries. Some developers may wish to use the coprocessor during special circumstances, such as at interrupt level or installing their own hardware floating point exception handlers. In these two situations, there are special requirements that must be met. These requirements will require floating–point assembly code and are discussed in this Technical Note. Changes since June 1989. Noted that the new Sound Manager no longer uses floating-point numbers at interrupt time. Name = TN.236.Speedy Coprocessor Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.236.Speedy Coprocessor Size: 27K Date: 2/15/91 Version: AMUG file information and description: TN.236.Speedy Coprocessor - This Technical Note presents an overview of the 68881 and 68882 math coprocessors, and it covers general information about the chips as well as how using the chips directly can help speed your math–intensive code. Name = TN.237.TextEdit Limits Again Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.237.TextEdit Limits Again Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.237.TextEdit Limits Again - This Technical Note describes another limit on the length of a TextEdit record that was previously undocumented. The TextEdit chapters in Inside Macintosh document the 32K character limit on a TextEdit record length. They do not, however, discuss the more subtle constraint on the size of the destRect. By definition, the destRect uses integer values for the top-left and bottom-right boundary points. It is possible to have values too large for the destRect without reaching the teLength limit. Name = TN.238.Getting a Full Pathname Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.238.Getting a Full Pathname Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.238.Getting a Full Pathname - This Technical Note describes how to generate a full pathname, given either a Working Directory ID or a real vRefNum and a DirID. By using the techniques shown in this Note, you can find the full pathname from information such as that returned by Standard File. Changes since June 89. Added a note on how to check for A/UX. Fixed bug in C version: BlockMove() parameters were reversed in pStrcpy(); added range checking to pStrCat(); changed references from “longint” to “long”. Fixed bug in Pascal and C versions: Changed fsRtDir to fsRtdirID and made references to gHaveAUX consistent. Name = TN.239.Inside Object Pascal Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.239.Inside Object Pascal Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.239.Inside Object Pascal - This Technical Note briefly explains why Object Pascal and MacApp should only be used to write applications and MPW tools. Although Pascal can be used to write desk accessories, drivers, XCMDs and other types of stand–alone code, and Object Pascal is an extension of Pascal, Object Pascal cannot be used to write anything other than an application. This limitation is due to the fact that Object Pascal method dispatching relies on a valid A5 pointing to a jump table. Because MacApp is written in Object Pascal, this limitation applies to it as well. Name = TN.240.MPW for Non-Mac Systems Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.240.MPW for Non-Mac Systems Size: 17K Date: 2/15/91 Version: AMUG file information and description: TN.240.MPW for Non-Mac Systems - Occasionally there is a need to create routines or programs for non-Macintosh systems. Such situations can occur if you are writing a driver for a NuBus board, developing a peripheral that uses a 68xxx microprocessor, or perhaps targeting a proprietary 68xxx machine (Apple uses MPW for all of its ROM and NuBus development.) Name = TN.241.ScriptMgr Pixel2Char Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.241.ScriptMgr Pixel2Char Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.241.ScriptMgr Pixel2Char - This Technical Note discusses the Pixel2Char routine provided by the Script Manager. Changes since June 1989: Clarified information, corrected minor errors, and replaced the illustration. The leftSide flag in the Pixel2Char routine was inappropriately named, and it should now be called the leadingEdge flag. The reason for this change is that the value Pixel2Char returns indicates whether a mouse-down occurred on the leading edge of a character, which is not always the left side. (In Arabic or Hebrew, both of which are right-to-left scripts, the mouse-down occurs on the right side of the character.) Name = TN.242.Fonts and the Script Mgr Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.242.Fonts and the Script Mgr Size: 12K Date: 2/15/91 Version: AMUG file information and description: TN.242.Fonts and the Script Mgr - The traps _FontScript, _IntlScript, and _Font2Script all use a font family ID to determine the script interface system code that they return. This Note describes the process, the way the Script Manager renumbers the Chicago font for non-Roman systems, and the equation for calculating Script IDs from font family IDs. Name = TN.243.Script Mgr Variables Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.243.Script Mgr Variables Size: 24K Date: 2/15/91 Version: AMUG file information and description: TN.243.Script Mgr Variables - The Script Manager maintains a number of global variables which can be read with the routine _GetEnvirons. These variables can be set by a corresponding routine, _SetEnvirons. In addition, each script interface system maintains variables of its own. These are referred to as local variables in Inside Macintosh, Volume V-293, The Script Manager, and are read by _GetScript and set by _SetScript. Name = TN.244.Color Cursor Cursing Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.244.Color Cursor Cursing Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.244.Color Cursor Cursing - Working with color cursors you create from scratch can cause headaches. This Technical Note may help a bit. Changes since June 1989: Added a warning about purgeable 'clut' resources. If you’re building an application that creates color cursors, you may encounter some quirks present in Color QuickDraw that manifest themselves in hard-to-understand ways. Name = TN.245.Font Family Numbers Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.245.Font Family Numbers Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.245.Font Family Numbers - This Technical Note discusses the range of numbers available for identifying font families, how they are allocated among script systems, what numbers should be used for fonts that were designed to be used as a tool in an application, and Apple’s font registration program. Name = TN.246.Mixing HFS and C I/O Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.246.Mixing HFS and C I/O Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.246.Mixing HFS and C I/O - This Technical Note discusses the problem of mixing calls to the Macintosh file system with calls to MPW C library file I/O routines. Problems with Communication Between HFS and C Frequently, developers want to use both Macintosh file I/O and C file I/O. Developers who do this must keep in mind that they are combining two distinct file representations (the Macintosh and ANSI C). The only limitation on mixing HFS and C I/O functions is that they cannot be mixed on the same open file. There are three reasons why this cannot be done. Name = TN.247.DeskHook and INIT Evils Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.247.DeskHook and INIT Evils Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.247.DeskHook and INIT Evils - This Technical Note discusses INIT evils, the foremost of which deals with clearing DeskHook and DragHook at INIT time Changes since August 1989. Added warning about clearing DragHook.If you’ve survived the typical DTS Tirade* and still feel the need to display a dialog box or window in an INIT, you need to be aware of a problem which exists on Macintoshes earlier than the Macintosh II (remember those?). There is a low-memory global named DeskHook ($A6C), which can contain a pointer to a routine responsible for painting the Macintosh desktop. Name = TN.248.DAs in Need of Time Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.248.DAs in Need of Time Size: 9K Date: 2/15/91 Version: AMUG file information and description: TN.248.DAs in Need of Time - This Technical Note describes a few complications which rear their rather ugly little heads when a desk accessory or driver needs periodic time. It also presents a few solutions to work around these problems and make life easier, at least periodically. Changes since August 1989: Corrected _BitClr and _BitSet examples. Okay, I admit it. I was having too good of a time when I wrote the original Note and messed up the bit manipulations at the end. My vision was blurred; I was in no condition to see those tiny little things. Name = TN.249.Opening Serial Driver Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.249.Opening Serial Driver Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.249.Opening Serial Driver - This Technical Note describes the recommended, safe, and compatible way to open the Macintosh serial driver, and it explains why you should no longer check for port availability. Changes since October 1989: Corrected syntax errors in the sample code. Name = TN.250.AppleTalk Phase 2 Path = AMUG CD:Files:MacTechNotes:TN.201.250:TN.250.AppleTalk Phase 2 Size: 33K Date: 2/15/91 Version: AMUG file information and description: TN.250.AppleTalk Phase 2 - This Technical Note discusses the new features and calls available with AppleTalk Phase 2. Changes since August 1989. Incorporated the ClosePrep and CancelClosePrep transitions and the new control calls to the .MPP driver.AppleTalk Phase 2 is only available on Macintosh Plus or later Macintosh platforms, and it requires the installation of AppleTalk file V53, or greater. Both EtherTalk 2.0 and TokenTalk 2.0 automatically install this AppleTalk file. Developer Technical Support can supply the Phase 2 drivers for development use; however, if you need to include the Phase 2 drivers in your product, you must license them from Software Licensing. Name = TN.251.Safe cdevs Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.251.Safe cdevs Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.251.Safe cdevs - This Technical Note describes a potential problem with Control Panel devices (cdevs) that contain EditText fields and presents a way to avoid it. The Control Panel chapter in Inside Macintosh, Volume 5 describes, in detail, how run-time errors are handled by the Control Panel and a cdev. There is, however, a potential problem with cdevs that contain EditText items that this chapter does not cover. Name = TN.252.Plotting Small Icons Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.252.Plotting Small Icons Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.252.Plotting Small Icons - This Technical Note discusses the 'SICN' resource format and how to plot one in a GrafPort. Changes since August 1989. Corrected errors in the Pascal code and spruced up the rest. Name = TN.253.SICNs in Menus Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.253.SICNs in Menus Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.253.SICNs in Menus - This Technical Note describes a new facility of the Menu Manager which allows you to add reduced icons and small icons to your menus. Changes since August 1989. Corrected references to SetItemCmd from SetItmCmd. Name = TN.254.Portable PDS Development Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.254.Portable PDS Development Size: 16K Date: 2/15/91 Version: AMUG file information and description: TN.254.Portable PDS Development - The Technical Note describes the unique aspects of the Macintosh Portable Processor Direct Slot (PDS), including the severe limitations in its use. Changes since October 1989. Corrected PDS pin and signal descriptions in Tables 2 and 3. Name = TN.255.Portable ROM Expansion Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.255.Portable ROM Expansion Size: 19K Date: 2/15/91 Version: AMUG file information and description: TN.255.Portable ROM Expansion - This Technical Note explains the practice of and theory behind compatible use of the expansion ROM in the Macintosh Portable. Due to the unique nature of the Macintosh Portable, developers now have the ability to add ROM to the Macintosh. To provide for compatible shared use of this ROM space with Apple and other developers, this Note describes the feature and suggests methods of shared implementation. Name = TN.256.Stand-Alone Code.cpt Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.256.Stand-Alone Code.cpt Size:131K Date: 2/15/91 Version: AMUG file information and description: TN.256.Stand-Alone Code.cpt - This Technical Note discusses many of the issues related to stand-alone code modules. This Note is by no means a completely original work, as the author borrows freely from the work of Keith Rollin, Mark Baumwell, and Jim Friedlander. Changes since October 1989. Completely rewritten to broaden the discussion of stand-alone code modules and include a greater scope of examples. Incorporates Technical Notes #110, MPW: Writing Stand-Alone Code and #145, Debugger FKEY. Name = TN.257.Slot Interrupt Priority Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.257.Slot Interrupt Priority Size: 3K Date: 2/15/91 Version: AMUG file information and description: TN.257.Slot Interrupt Priority - This Technical Note describes the way interrupt priorities are scheduled, which corrects the description of slot interrupt queue priorities in the Device Manager chapter of Inside Macintosh, Volume V-426. Name = TN.258.Our Checksum Bounced Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.258.Our Checksum Bounced Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.258.Our Checksum Bounced - This Technical Note discusses a fix to a SCSI Manager bug which concerns all developers working with SCSI and NuBus™ device drivers. Name = TN.259.Old Style Colors Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.259.Old Style Colors Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.259.Old Style Colors - This Technical Note covers limitations of the original Macintosh color model (eight-color) which Inside Macintosh, Volume I-173, QuickDraw does not document. Changes since October 1989. Added definitions of the old-style constants. Name = TN.260.NuBus Power Limits Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.260.NuBus Power Limits Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.260.NuBus Power Limits - This Technical Note discusses a very real power limit for NuBus™ expansion cards and warns developers to heed this limit lest they want users trashing their machines by overextending the Macintosh power supply. Name = TN.261.Cache As Cache Can Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.261.Cache As Cache Can Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.261.Cache As Cache Can - This Technical Note documents some new traps for manipulating the data and instruction caches on 68030-based Macintosh models and describes the MMU mapping set up by the ROMs for NuBus™ cards. The Motorola MC68030 CPU used by the Macintosh IIx, IIcx, IIci, and SE/30 includes a data cache, an instruction cache, and a MMU (Memory Management Unit). This Note describes the problems that data caching can cause, Apple’s solution to this problem, and additional information about MMU mapping on MC68030-equipped machines. Name = TN.262.Controlling Status Calls Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.262.Controlling Status Calls Size: 4K Date: 2/15/91 Version: AMUG file information and description: TN.262.Controlling Status Calls - This Technical Note discusses situations under which high-level Status calls do not work correctly and PBStatus calls should be made instead. Name = TN.263.International Canceling Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.263.International Canceling Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.263.International Canceling - This Technical Note describes potential problems canceling operations with the Command-period key sequence and international keyboards. Name = TN.264.Date & Time Problems Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.264.Date & Time Problems Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.264.Date & Time Problems - This Technical Note describes known bugs and features in and solutions to the date and time routines introduced in Script Manager 2.0. From the beginning, the Macintosh’s ability to handle dates was limited to a rather small range—slightly more than a century. Enhancements to the Script Manager, introduced with System Software 6.0, extended this range to ±35,000 years. Unfortunately, there is a minor bug in one of the crucial calls and a “feature” that looks like a bug in another. Name = TN.265.Pascal to C PROC Parms Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.265.Pascal to C PROC Parms Size: 16K Date: 2/15/91 Version: AMUG file information and description: TN.265.Pascal to C PROC Parms - This Technical Note talks about nested procedures and PROCEDURE parameters in Pascal and what to do when converting them into C or C++. Changes since February 1990. Fixed some type coercion problems. Name = TN.266.Pointing Device Struct Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.266.Pointing Device Struct Size: 18K Date: 2/15/91 Version: AMUG file information and description: TN.266.Pointing Device Struct - This Technical Note specifies a memory data structure for use by absolute pointing devices; it was developed for the Apple Desktop Bus (ADB) but could also be used for devices using serial input. Generally, this data structure is created and updated by the pointing device’s driver and read by either an application or the system cursor rendering software. Name = TN.267.TE Technicalities Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.267.TE Technicalities Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.267.TE Technicalities - This Technical Note discusses some areas in TextEdit that have not previously been clearly documented. Name = TN.268.MacinTalk Final Chapter Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.268.MacinTalk Final Chapter Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.268.MacinTalk Final Chapter - This Technical Note discusses the MacinTalk software product. The Introduction. For the introduction of the Macintosh computer, it was decided (by the powers formerly in charge) that such a computer would need something very special to make it a unique event. To aid in this concept, a third-party company was contracted to write a speech synthesizer which would allow the Macintosh computer to introduce itself. The contract was signed, and the work begun. Name = TN.272.Sony Drives For You Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.272.Sony Drives For You Size: 25K Date: 2/15/91 Version: AMUG file information and description: TN.272.Sony Drives For You - This Technical Note discusses the Sony driver control and status calls that are available on the Macintosh. Changes since April 1990. Corrected Figure 2, since the Return Physical Drive Icon (csCode = 21) returns an error message instead of an icon on the Macintosh Plus. This Note covers the external (software) interface to the Sony 3.5” floppy disk and Hard Disk 20 driver. It describes all the new calls, including those for Modified Frequency Modulation (MFM) driver versions. This discussion assumes a general understanding of the operation of Macintosh drivers. Name = TN.273.SCSI Termination Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.273.SCSI Termination Size: 11K Date: 2/15/91 Version: AMUG file information and description: TN.273.SCSI Termination - This Technical Note discusses SCSI termination on the Macintosh, including the new rules of termination which are necessary with the advent of the high-speed Macintosh IIfx. Changes since April 1990. Fixed a typographical error which represented µF as mFWhy Is The Terminator After Sarah Connor? One of the features of the Macintosh IIfx is a new SCSI chip that provides SCSI data transfer rates up to three megabytes per second, faster than any existing Macintosh model. To achieve these transfer rates, components on the Macintosh IIfx logic board are smaller and faster, requiring different termination configurations than previous Macintosh models. Name = TN.276.Gimmie Depth or Death Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.276.Gimmie Depth or Death Size: 8K Date: 2/15/91 Version: AMUG file information and description: TN.276.Gimmie Depth or Death - This Technical Note describes two new system calls that allow an application to change the depth and flags for a given device and also check whether a device supports a particular depth and flags setting. Apple provides these calls to give developers a better way to help users make changes when they consider it appropriate. Abusive use of these calls is a sure way to guarantee that the Thought Police come after you to confiscate your Macintoshes, your stock of Mountain Dew®, and your Technical Notes binder. This Note assumes familiarity with Inside Macintosh, Volume V, Graphics Devices. Name = TN.277.Time Space _CopyBits Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.277.Time Space _CopyBits Size: 25K Date: 2/15/91 Version: AMUG file information and description: TN.277.Time Space _CopyBits - This Technical Note describes the various factors that can influence the speed of _CopyBits so that developers can set up conditions to achieve the best performance for the particular situation. Name = TN.278._PBClose the Barn Door Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.278._PBClose the Barn Door Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.278._PBClose the Barn Door - You may get the idea when implementing device drivers that _PBClose is superfluous. After all, if you have a resident driver for a NuBus™ video board, the only time your driver is not needed is if the operating system is going away. It might seem that nothing important can happen after the operating system goes away, so why bother with _PBClose? Well, it turns out a lot can happen, and this Note tells you why it is important to implement a Close (_PBClose) routine. Name = TN.279.LDEF Madness Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.279.LDEF Madness Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.279.LDEF Madness - This Technical Note uncovers a problem with writing Pascal list definition procedures and two (yes, count ’em, two) different methods to work around it. Name = TN.280.MacApp Bugs 3.0 Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.280.MacApp Bugs 3.0 Size: 51K Date: 2/15/91 Version: AMUG file information and description: TN.280.MacApp Bugs 3.0 - This Technical Note describes the latest information about bugs or unexpected “features” in MacApp. Where possible, solutions and fixes are noted. DTS intends this Note to be a complete list of all known bugs in MacApp and will update it as old bugs are fixed or new ones appear. If you have encountered a bug or unexpected feature which is not described here, be sure to let DTS know. Specific code examples and suggested fixes are useful. Name = TN.281.Multiple Inheritance Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.281.Multiple Inheritance Size: 10K Date: 2/15/91 Version: AMUG file information and description: TN.281.Multiple Inheritance - This Technical Note answers a common question about MPW C++: “Why doesn’t HandleObject support multiple inheritance?” It does this by giving a brief overview of how multiple inheritance is implemented in MPW C++. Name = TN.282.Smear Tactics Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.282.Smear Tactics Size: 5K Date: 2/15/91 Version: AMUG file information and description: TN.282.Smear Tactics - This Technical Note discusses a feature of the current Macintosh hardware which will not be supported in the future. Macintosh hardware developers and driver writers should be aware of this limitation as it affects current and future products. Name = TN.283.A/UX System Calls Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.283.A/UX System Calls Size: 21K Date: 5/18/91 Version: AMUG file information and description: #283 A/UX System Calls From Macintosh Software. Revised by Anathan Srinivasan & Kent Sandvik January 1991. Written by Rob M. Smith, B. W. Hendrickson & Dave Radcliffe August 1990. This Technical Note discusses how to make A/UX system calls from applications developed in the Macintosh environment. This is useful to anyone porting an existing Macintosh driver or application to work on A/UX as well. Changes since August 1990. Added information about how to make use of fork() system calls under MultiFinder, as well as how various A/UX system calls behave under the MultiFinder emulation mode. Name = TN.284.IOP Diffs Under A/UX Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.284.IOP Diffs Under A/UX Size: 6K Date: 2/15/91 Version: AMUG file information and description: TN.284.IOP Diffs Under A/UX - This Technical Note discusses use of the Macintosh IIfx IOP-based serial driver under A/UX, especially under certain error conditions which cause it to perform differently than documented in termio(7). (The SCC driver, used on non-IOP machines, conforms to termio(7) in all cases.) References to “the driver” herein refer to the IOP-based serial driver, seriop.c. Name = TN.285.GetPhysical Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.285.GetPhysical Size: 20K Date: 5/18/91 Version: AMUG file information and description: #285 Coping With VM and Memory Mappings. Revised by Craig Prouse April 1991 Written by Craig Prouse February 1991. The purpose of this Note is twofold. First, it describes in detail how to use the GetPhysical routine. This routine is critical to the support of alternate bus masters on certain machines without Virtual Memory (VM) and all machines with VM. Included is an ancillary discussion of several closely-related VM routines. Second, it reiterates a number of issues important to VM compatibility and elucidates some of the deeper VM issues of which specialized developers should be aware. Name = TN.286.GPi The Reliable Way Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.286.GPi The Reliable Way Size: 9K Date: 4/28/91 Version: AMUG file information and description: #286 - The Serial General-Purpose Input (GPi). Written by Craig Prouse February 1991. This Technical Note discusses the latest supported methods for reading, validating, and configuring the GPi serial input across all members of the Macintosh family. Name = TN.287.Spare A Block Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.287.Spare A Block Size: 13K Date: 4/28/91 Version: AMUG file information and description: #287 Hey Buddy, Can You Spare A Block? Written by Philip D. L. Koch, Jim Reekes, & Kenny Tung February 1991. This Technical Note discusses a new feature of the System Software 7.0 Disk Initialization Package—bad block sparing. Name = TN.288.NuBus Block Transfers Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.288.NuBus Block Transfers Size: 11K Date: 4/28/91 Version: AMUG file information and description: #288 NuBus Block Transfer Mode sResource Entries. Written by Guillermo Ortiz February 1991. This Technical Note describes the sResource entries needed in a declaration ROM to inform NuBus™ masters when a board is capable of receiving or sending block transfers. Name = TN.289._CopyBits & GC QuickDraw Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.289._CopyBits & GC QuickDraw Size: 7K Date: 4/28/91 Version: AMUG file information and description: #289 Deaccelerated _CopyBits & 8•24 GC QuickDraw. Written by Guillermo A. Ortiz February 1991. This Technical Note discusses conditions that may cause _CopyBits to slow down when QuickDraw acceleration is on via the Apple 8•24 GC Display Card. Name = TN.290.WDEF and wDraw Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.290.WDEF and wDraw Size: 4K Date: 4/28/91 Version: AMUG file information and description: #290 Custom WDEF and wDraw. Written by Vincent Lo February 1991. This Technical Note explains why custom window definition functions may not respond to a wDraw message from the system (if you follow the documentation in Inside Macintosh). Name = TN.291.CMOS On LC PDS Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.291.CMOS On LC PDS Size: 4K Date: 4/28/91 Version: AMUG file information and description: #291 CMOS On Macintosh LC PDS. Written by Paul Baker & Rich Collyer February 1991. This Technical Note provides PDS card developers with some important information about making PDS cards for the Macintosh LC. Name = TN.292.Bus Error Handlers Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.292.Bus Error Handlers Size: 11K Date: 4/28/91 Version: AMUG file information and description: #292 Bus Error Handlers. Written by Wayne Meretsky & Rich Collyer February 1991. This Technical Note discusses bus errors and how applications and drivers should deal with them. Name = TN.293.Excellent CD Notes Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.293.Excellent CD Notes Size: 13K Date: 4/28/91 Version: AMUG file information and description: #293 Most Excellent CD Notes. Written by James Beninghaus February 1991 This Technical Note discusses issues concerning the use of the AppleCD SC drive, the Apple CD-ROM device driver, and the Foreign File Access software extension. Name = TN.300.My Life as a ... (MW) Path = AMUG CD:Files:MacTechNotes:TN.251.300:TN.300.My Life as a ... (MW) Size: 12K Date: 9/28/91 Version: AMUG file information and description: Technical Note #300 - This Technical Note discusses the PascalObject base class, used, for instance, with MacApp programming. The Technical Note describes how to write PascalObject derived classes that work with both Object Pascal and C++ code linking. It also describes the current restrictions and bugs with writing C++ code using PascalObject as the base class. This Technical Note is based on MacApp 2.0(.1), MPW 3.2 and MPW C++ 3.1. Name = TN.301.File Sharing and Shared Path = AMUG CD:Files:MacTechNotes:TN.301.350:TN.301.File Sharing and Shared Size: 9K Date: 9/28/91 Version: AMUG file information and description: Technical Note #301 - This Note describes modifications to the existing File Manager routines, PBGetCatInfo, PBHGetDirAccess, PBHSetDirAccess, PBHSetFLock and PBHRstFLock, when used on volumes prepared by Macintosh System 7 File Sharing. Name = TN.302.Help For Movable(MW) Path = AMUG CD:Files:MacTechNotes:TN.301.350:TN.302.Help For Movable(MW) Size: 6K Date: 9/28/91 Version: AMUG file information and description: Technical Note #302 - This Technical Note describes the process by which an application can remap the Help Manager 'hmnu' resource while a movable modal dialog box is on the screen. The Help Manager handles the case for modal dialog boxes but punts in the case of movable modal dialog boxes. The following information will help you get the correct interface performance. Name = TN.303.PurgeProc Note(MW) Path = AMUG CD:Files:MacTechNotes:TN.301.350:TN.303.PurgeProc Note(MW) Size: 6K Date: 9/28/91 Version: AMUG file information and description: Technical Note #303 - This Technical Note discusses the use of the purgeProc field of an application’s heap zone. Most applications will never need to use a purgeProc. However, if your application requires the ability to maintain purgeable handles containing data, or you need to have special notification when a certain handle is purged, a purgeProc might help you. Name = TN.304.Update Perils(MW) Path = AMUG CD:Files:MacTechNotes:TN.301.350:TN.304.Update Perils(MW) Size: 14K Date: 9/28/91 Version: AMUG file information and description: Technical Note #304 - This Technical Note discusses potential problems when pending update events for windows behind modal dialogs are not serviced. This note also documents some new System 7 Dialog Manager calls. Name = TN Indices 10-90.dd Path = AMUG CD:Files:MacTechNotes:TN Indices 10-90.dd Size:116K Date: 2/15/91 Version: AMUG file information and description: TN Indices 10-90.dd is the Technotes indices from 10-91. Name = TN Stack Fonts Path = AMUG CD:Files:MacTechNotes:Technical Notes Stack:TN Stack Fonts Size: 19K Date: 2/15/91 Version: AMUG file information and description: TN Stack Fonts contains the necessary fonts for running your TN Stack. Name = Tech Note PICTs.dd Path = AMUG CD:Files:MacTechNotes:Technical Notes Stack:Tech Note PICTs.dd Size:187K Date: 2/15/91 Version: AMUG file information and description: Tech Note PICTs.dd contains various picts for the Tech notes provided in this section. Name = Technical Notes Stack 3.2.1 Path = AMUG CD:Files:MacTechNotes:Technical Notes Stack:Technical Notes Stack 3.2.1 Size:983K Date: 2/15/91 Version: 3.2.1 AMUG file information and description: Technical Notes Stack 3.2.1 is a complete listing of all Tech Notes in hypercard format.